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I Preface 


The MWX-ICE debugger is an integrated debugger for use with 
the Applied Microsystems SuperTAP™ 8XX systems 
integration tool. 


Note 



The manuals for this product are revised only at major releases 
of hardware or software. Changes that occur between major 
releases are noted only in the Help, readme, or release notes. 
Therefore, any differences between the Help and this document 
are because the Help is more current. 



Documentation overview 


This manual provides information that is specific to using 
MWX-ICE with the SuperTAP emulator for the Motorola 
MPC8XX processors. MWX-ICE is based on XRAY for 
Windows from Microtec. While MWX-ICE does not support 
every XRAY feature, it includes many additional features that 
support debugging with Applied Microsystems in-circuit 
emulators. For information on compatibility, see the readme 
file provided with this release. 

For information on installing the SuperTAP hardware, see the 
Emulator Installation Guide, 

MWX-ICE User’s Manual 


For information on 

See 

Conventions, support services. 

This chapter 

Key emulation features. 

Chapter 1 

Installing and starting MWX-ICE, and 
SuperTAP operational characteristics. 

Chapter 2 

Using overlay memory. 

Chapter 3 

Programming flash memory. 

Chapter 4 

Using trace capture and display. 

Chapter 5 

Using standard breakpoints. 

Chapter 6 

Using the event system. 

Chapter 7 

Register support for MPC8XX family. 

Chapter 8 

Command syntax and groupings, 
unsupported XRAY commands, using 
Help for detailed conunand descriptions. 

Chapter 9 


XVI 
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For information on 


See 


A tutorial and examples of how to use 
MWX-ICE features. 

Chapter 10 

Modifying the startup files. 

Appendix A 

Common startup problems and error 
messages. 

Appendix B 

How the cdemon tutorial code works. 

Appendix C 

Updating the emulator’s firmware. 

Appendix D 

Finding information in this manual. 

Index 


Using Help 

The Help for MWX-ICE also covers all the emulator-specific 
and core debugger features: 

□ Detailed command descriptions. 

□ Using windows, menus, and notebooks. 

□ Using MWX-ICE features (for example, breakpoints, event 
system, overlay memory, trace memory, s 3 mibol 
management, macros). 

To get Help 

From the Help menu, choose Contents, or choose Help on the 
ciurently active window. You can also search the Help file for 
keywords or command names. To get help on MWX-ICE 
debugger notebooks, click the question mark button (?) in the 
notebook. 

For help on using Windows Help, press FI in the Help window, 
or choose How to Use Help from the Help menu. 


SuperTAPSXX 
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Installation and emulator setup 


For information on 

Installing the debixgger 
Starting the debugger 
Setting up the emulator 


See _ 

Chapter 2 of this manual. 
Chapter 2 of this manual 

SuperTAP Emulator Installation 
Guide 
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Conventions 


This manual uses the following conventions: 

When you see This means 

bold type The name of a control software 

configuration or executable file, a 
keyword or command. 

italics A command variable or a file name that 

you need to type. Itahcs are also used 
for emphasis the first time a key word 
or concept is introduced. 

<F7> Press the F7 ftinction key. 

[ ] Optional item. You do not have to select 

the option. You do not type the 
brackets. 

I A choice between two or more options. 

Do not type the vertical bar. 

{} The curly braces indicate that must 

choose one item. Do not type the braces. 

You may select one or more of the 
items. Do not type the elhpsis. 

run Screen output or example code. 
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Support services 

Applied Microsystems provides a full range of support services. 
New software is covered by a 90-day warranty. Support 
agreements are available that provide additional services. 

If you encounter trouble installing or using your software, 
consult your manuals to verify that you are using appropriate 
procedures. For answers to common troubleshooting problems, 
see Appendix B. It covers the most frequently encoimtered 
operational problems. 

If the problem persists, call Customer Support. 

When you contact Customer Support, please have the ASI 
(Apphed System Identifier) number of your system. The ASI 
number is printed on a label located on the bottom of the 
SuperTAP. 

Phone 

(800) ASK-4AMC (275-4262) 

(206) 882-2000 (in Washington State and Canada) 

See inside back page for addresses and phone numbers of 
worldwide offices. 

Internet address 

If you have access to the Internet, you can contact Apphed 
Microsystems Customer Support using the following email 
address: 

support@amc.com 

You can also browse the Apphed Microsystems World Wide 
Web page using the following URL: 

http://www.amc.com 

FAX 

(206) 883-3049 


XX 
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Chapter 1 

Introducina MWX-ICE 


This chapter covers key features of the Apphed Microsystems 
MWX-ICE debugger for the Motorola MPC8XX processors. The 
MWX-ICE debugger is used in conjunction with the Applied 
Microsystems SuperTAP system integration tool. 

The following sections provide a quick overview of key features 
and characteristics of the SuperTAP emulator and MWX-ICE 
debugger. It includes pointers to additional information, 
required setup, and procedures. 


Contents Page 


The SuperTAP system integration tool 1-3 

Run control, memory and register support 1-3 

Trace system 1-7 

Event system 1-7 

DPI mode 1-8 

Flash programming 1-9 

File formats and converters 1-9 

File formats and converters 1-9 

Built-in network support 1-10 
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The SuperTAP system integration tooi 

The SuperTAP is your one complete tool for ^stem debugging 
and integration. You can use the SuperTAP and MWX-ICE in 
full in-circuit emulation (ICE) mode, where the SuperTAP 
replaces the target processor, or in DPI-only mode, where the 
SuperTAP connects to the DPI port on the target. In DPI-only 
mode you can access the built-in debug mode of the MPC8XX 
processor. 

You can use SuperTAP and the MWX-ICE in full in-circuit 
emulation mode to bring up your target hardware, program 
flash memory, or to execute code from the emulator’s overlay 
memory. The SuperTAP also supports external bus masters in 
multi-processor target systems. 

SuperTAP provides the following features: 

□ Run control, memory and register visibihty. 

□ Trace system to record processor activity. 

□ Event system to track and isolate deeply nested bugs. 

□ Overlay memory to use in place of target memory. 

□ Program flash memory. 

□ Built-in Ethernet Communications. 


These features are described on the following pages. 
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Trace system 

\ 

Event system 


Kun ccntrcl, memory and 
register visibiirty 


Program flash memory 



Connect to the target in 
full ICE or DPI-only mode 


Use overlay memory in 
place of target memory 


Full debu^ support for ELF 
object modules with 
DWAPF or stabs debu^ 
information 

3uilt-in Ethernet network 
capability 


Run control, memory and register support 

Using the SuperTAP and MWX-ICE you can control target 
execution, examine and modify memory and registers. 


Run control 

You can use the run control system to single-step through your 
application code at the source or assembly-level. You can step 
into or over function calls. You can set instruction or access 
breakpoints in target RAM or ROM. 
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Basic breakpoints 


Basic breakpoints are tools for interrupting emulation or 
simulation in order to inspect trace for insight into code 
execution and tai^et function. Breakpoints interrupt 
emulation after memory accesses or before executing an 
instruction. 

You use a breakpoint to examine behavior of the target under 
certain controlled conditions. This is very helpful in isolating 
bugs when troubleshooting hardware and software in the 
target environment. 

T 3 rpically, they take two forms: access breakpoints and 
instruction breakpomts. You can use up to 10 single-address 
access breakpoints or five ranges, or some combination of both 
t 3 ^es. You can set up to 50 software instruction breakpomts. 

See the breakaccess, breakinstruction, breakread, and 
breakwrite command descriptions in the Help. Chapter 6 
provides a detailed explanation of the basic breakpoint system. 
The tutorial in Chapter 10 offers some practical examples of 
procedures and applications. 

Operations during run 

In the standard operating mode, MWX-ICE does not permit 
additional operations while the emulator is running. 
MWX-ICE for the MPC8XX family has a special dynamic run 
mode. 

The drun (dynamic run) command executes the target 
program and continues execution until it is stopped by the 
dstop command, a breakpoint, or an error. The purpose of this 
mode is to allow you to interact with the emulator and 
debugger d 3 mamically, while the emulator is running. 

In dynamic nm mode you can examine and qualify trace, set 
and change events and breakpoints, examine and change 
memory and perform most other interactive emulation 
functions. 
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You can use the dupdate command to poll the emulator 
periodically and update the windows during dynamic run 
mode. However, d 3 mamic commands are no longer accepted. 

The drun, dstop, dupdate commands provide this additional 
functionality. Help describes each command in detail. The 
tutorial in Chapter 10 includes a simple application. 

Servicing interrupts during pause 

Normally, a breakpoint causes the emulator to stop running in 
target. Using the sitstate command, you can enable 
Stop-in-Target (SIT) mode and have the emulator loop in target 
and service interrupts while paused, or jump to your own 
interrupt service routine. When sitstate is set for ice 
(in-circuit emulator mode), the sit command specifies the 
beginning of a minimum 4-byte block of memory at which it 
installs the loop routine. A branch instruction is placed at the 
loop address. When an interrupt request is detected, the 
processor services the interrupt, then returns to the branch 
loop. 

When sitstate is set to user, the sit command specifies the 
beginning of your own interrupt service routine. 

The default address for the emulator’s loop or yoxir own 
interrupt service routine is set by the sit command. This 
setting must be changed, either from the command line or in 
the Execution dialog of the Emulator Configuration window, 
before setting sitstate to ice or user. 

Help provides complete descriptions of the sit and sitstate 
commands and explains setup. 


Overlay memory 

You can configure fiie SuperTAP with up to 8 MB of overlay 
memory. Overlay is RAM that can be mapped into the target 
system’s memory space, either in place of memory or in 
addition to target system memory. Overlay is useful for 
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replacing target ROM for debugging purposes, or as a stable 
environment when target memory is unreliable, or to 
temporarily expand target memory for test routines. 

In addition, you can configure the SuperTAP to allow external 
bus masters to access overlay memory. 

The map, copy, and overlay commands are the primary 
MWX-ICE commands used to map overlay and copy contents to 
and from target and overlay. These are described in Help. A 
description of overlay features, operation, and mapping is 
provided in Chapter 3. 


Register support 

MWX-ICE supports all registers of the MPC8XX family 
processors. Register values can be viewed, modified, and used 
within the conditional event system. 

The SuperTAP provides: 

□ Windowed display and modification of all MPC8XX 
registers. 

□ Current value and descriptions of each bit in the register 
sets using the CPU Browser. 

□ Monitoring and manipulation of MPC8XX family registers 
during run using the event system. 

Chapter 8 describes the features provided for viewing and 
modifying the MPC8XX registers, and fists all supported 
registers with the mnemonics used by the debugger. 

Session logging 

You can use the log and journal commands to record all 
session activity, including commands issued, error messages, 
and data returned. The log file can be used as an include file to 
replicate an earlier session. Help describes both conunands. 
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Trace system 


You can use the emulator's trace system to capture and record 
the execution history of the processor as the emulator executes 
the target program. Information captured includes CPU 
address, data, and status signals and timestamp information, 
as well as several optiongJ fields such ais interrupt activity. 
Using trace history, you can verify the correct performance of 
the software and find errors that may occur in the program's 
execution. 

The emulator's trace buffer can store approximately 32,000 
frames of trace. Each trace frame contains 128 bits of 
information. Using emulator trace capture variables and the 
event system, you can selectively filter the kinds of processor 
activity you wish to capture. Once trace has been captured, you 
can use trace display variables to view the contents of the trace 
buffer in several different ways. You can display raw bus or 
clock cycles, full source-level, assembly-level, or mixed source- 
and assembly-level trace information. 

Chapter 5 explains and illustrates trace use. Help also 
provides complete information about trace setup, capture, and 
display. 


Event system 


The basic breakpoints feature and the event system can both be 
used to control emulation for insight into code execution and 
target function. Compared to basic breakpoints, the SuperTAP 
event system provides additional flexibility both in what can 
cause the emulator to intervene in code execution and in what 
actions can occur. 


SuperTAP 8XX 


The emulator’s event system is combined with the MPC8XX 
on-chip event system to provide a powerful state machine that 
monitors the processor bus and the event system counters. 
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groups, and state flags. The system can track deeply nested 
sets of conditions, including recursive and reentrant code 
sections. It allows you to monitor for a predefined series of 
conditions, called events, and then perform emulator actions 
based on those conditions. It monitors target information at the 
bus-cycle level, including every read or write cycle that the 
microprocessor executes. 

These features provide powerful debugging capabihties for 
software debugging and for hardware/software integration. 

□ Up to 32 when/then statements can be defined at any time. 

□ Four event groups and two event states provide the logical 
structure necessary for tracking deeply nested bugs. 

□ The event system includes 4 counters that can be monitored 
and controlled. 

□ Trace collection can be selectively controlled. 

□ Memory and register values can be monitored and modified. 

□ Emulation can be stopped before or after instruction 
execution. 

□ The event system can respond to or produce an external 
trigger signal. 

Chapter 7 provides a detailed explanation of event system 
apphcations and procedures. The when command is the 
primary MWX-ICE event system command. It, and the many 
associated commands, are described in Help. Help also 
provides extensive description of event system use. 

The tutorial in Chapter 10 offers some practical examples of 
procedures and applications. 


DPI mode 


You can use one tool for different kinds of debug problems. The 
SuperTAP can operate as a full-featured emulator and replace 
the processor in the target system, or it can connect to the 
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target system iisii^ just the Development Port Interface ODPI) 
cable and provide simple run control, plus memory and register 
control. MWX-ICE automatically detects the mode of 
operation, and configures itself accordingly. Procedures for 
connecting the SuperTAP to your target system are described 
in the Emulator Installation Guide. 


Flash programming 

Flash memory is widely used in embedded system designs 
because of its non-volatihty, high-performance, and low-cost. 
MWX-ICE and the SuperTAP provide a fast and efficient 
means of programming and erasing flash memory devices in 
your target system. The SuperTAP supports most popular flash 
memory devices from AMD and Intel. For information about 
using MWX-ICE to program flash memory, see Chapter 4 and 
Help. 


File formats and converters 

MWX-ICE requires ELF object format with DWARF debug 
information to enable symbolic debugging. You can also use the 
Gnu G-I-+ compiler with the -gstabs-t- option. 

Support for other formats is built into MWX-ICE and 
additional converters are available. 

In addition to ELF, the following formats are also recognized: 
Format Description 

INTEL Intel hex format. Extended segment 

address records and extended linear 
address records are supported. 
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Format 


Description 


SREC Motorola S3-records with Microtec 

(default) extensions. 

XTEK Extended Tektronics hex format. 

S 3 nnbols are not supported for these formats. 

See the descriptions of upl, dnl, uplfmt, and dnlfimt in Help 
for supported formats, procedures, and limitations. Contact 
your Applied Microsystems representative for information 
about additional converters. 


Built-in network support 

With built-in Ethernet communications support, the 
SuperTAP is network ready. Engineers can share access to the 
SuperTAP and the target system without having to add 
additional hardware to the target. The SuperTAP supports the 
widely-used TCP/IP network protocol. If your network uses 
RARP or BOOTP servers, the SuperTAP can automatically 
configure its IP address and netmask using your network 
database. Procedures for connecting the debugger to a 
networked SuperTAP are described in Chapter 2 of this 
manual. 

For information about configuring the SuperTAP hardware for 
Ethernet communications, see the Emulator Installation 
Guide. 
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Chapter 2 

Getting Started 


This chapter explains how to install and start the debugger and 
provides important information about characteristics of the 
emulator and debugger. Before you begin debugging, you 
should familiarize yourself with this information. 
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Installing MWX-ICE for Windows 

These instructions describe how to install the Apphed 
Microsystems MWX-ICE debugger on a PC or compatible 
computer that is running Microsoft Windows 95 or Windows 
NT version 4.0. 

□ Install the MWX-ICE software by following the instructions 
included with the CD-ROM. 

□ Configure the emulator for communications as described in 
the Emulator Installation Guide. 

□ Set the environment variables as described in “Setting up 
environment variables” on page 2-2. 


System requirements for MWX-ICE 

The Applied MLcrosystems MWX-ICE debugger runs on a PC or 
compatible computer that is running Microsoft Windows 95 or 
Windows NT version 4.0. 

For information on the specific host, network, and emulator 
requirements for this release of MWX-ICE, see the release 
letter and readme shipped with your order. 

MWX-ICE uses the Transmission Control Protocol/Intemet 
Protocol (TCP/IP) to communicate with the SuperTAP. Support 
for TCP/IP is built into Windows NT. If you are using Windows 
95, you need to add the Microsoft TCP/IP communications 
protocol. 


Setting up environment variables 

The default installation directory for MWX-ICE is C:\ST8XX. 
If you use this directory, you do not need to set up the 
XRAYMASTER environment variable, and you can skip this 
step. 
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Search order 


MWX-ICE searches for STAKTUP.INC and other MWX-ICE 
support files in the folloAving order: 

1. currentjdirectoryXSTARTUP.lMC 

2. current_directory\AM.C\ST8'XX.\filename 

3. XRAyMASTER\AMC\ST8XX\/iZenc7ne 

4. C:\ST8XX\AMC\ST8XX\/iZena7ne 

Setting XRAYMASTER 

If you have installed the MWX-ICE debugger in a directory 
different from the default, you need to set up the 
XRAYMASTER environment variable in your 
AUTOEXEC.BAT file. 

The S 3 uitax is: 

set XRAYMASTER=instaIl_dir 


Starting MWX-ICE 

To start MWX-ICE, you must have met the following 

requirements: 

□ MWX-ICE must be installed, and environment variables 
must be set. 

□ The SupeiTAP must be configured for Ethernet 
communications as described in the SuperTAP Emulator 
Installation Guide. 

□ A TCP/IP protocol stack must be running on your host 
computer, and your network must have some means of 
performing address resolution. 

This following section summarizes startup procedures for 

MWX-ICE. 


SuperTAP 8XX 
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Figure 2-1 MWX-ICE group in the Windows Start menu 


Using the Startup Options Editor 

To make selecting startup options easier, you can use the 
MWX-ICE Startup Options Editor. The editor creates a startup 
options file (MWX.CFG) that is automatically included when 
you start the debugger. 

> To use the Startup Options Editor 

1. Click the Start button, and point to Applied Microsystems, 
then point to MWX-ICE SuperTAP 8XX, and click the 
Startup Options Editor. 

The Startup Options Editor dialog appears. 

2. Select the processor variant you want to emulate. 

You must change this selection each time you change the 
processor you are emulating. 

3. Select other options as needed. 

For information on the available options, choose Help. 

4. Choose OK 
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The options editor saves your choices to a file (the default is 
MWX.CFG). 

>- To start MWX-ICE 

■ Click the Start button, and point to Applied Microsystems, 
then point to MWX-ICE SuperTAP 8XX, then click 
MWX-ICE. 

The debugger automatically looks for the file MWX.CFG, 
and uses those options at startup. If you save the options to 
a different file, you need to add a new program icon to the 
Start or Programs menu. For information, click Help from 
the Startup Options Editor, and see the “Add a new pro¬ 
gram” topic. 

If you want to use the same startup options the next time 
you start MWX-ICE, just double-click the appropriate 
MWX-ICE icon. 

The first time you start up MWX-ICE, the debu^er comes 
up in the unconnected state. For information on defining a 
connection, see “Connecting to an emulator” on page 2-7. 


SuperTAP 8XX 
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For more information about the startup options file, see “About 
the startup options file (MWX.CFGr on page A-7. 



Figure 2-2 MWX-ICE Startup Options Editor 
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Connecting to an emulator 

When you start up MWX-ICE you won’t automatically connect 
to an emulator unless you have saved your configuration to a 
startup file. If MWX-ICE is unable to locate a startup file 
(STARTUP.INC) the Connections window appears along with 
the Code and Command windows. You can use the Connections 
window to define and connect to an emulator. Once you have 
connected to an emulator, you can save the configuration. 

The section describes the steps needed to connect to an 
emulator. Before you can connect to an emulator, you must 
first configure the emulator for Ethernet commimications as 
described in the Emulator Installation Guide, 

Starting the emulator 

The SuperTAP has special buffering to protect the emulation 
circuitry. To function, emulator power must be on. Use the 
following sequence when powering on the emulator and target. 

If you do not have a target, the emulator goes into isolation 
mode. For information about using isolation mode, see 
“Isolation mode” on page 2-24. 


Note 



The first time you start MWX-ICE, do not have the tai^et 
connected. This will allow you to come up in isolation mode and 
configure MWX-ICE for your target requirements. Save the 
configuration so tiiat MWX-ICE will be configured correctly at 
startup when yoxir target is connected. 


> To start the emulator 

1. Turn on power to the emulator. 

2. Turn on power to the target. 


SuperTAP 8XX 
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Connection status 



Figure 2-3 Connections window [Not Connected] 
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Defining a connection 

Before you can connect to an emulator, you must define an 
emulator connection. You can define as many connections as 
you like, but you can only connect to one emulator at a time. 

> To define a connection 

1. From the Displays menu, select Connections. 

The Connections window appears. The Connections window 
automatically appears if MWX-ICE is xmable to locate a 
startup include file. 

2. From the Actions menu, choose Define Ethernet Connection. 
The Define dialog box appears. 



3. In the Host Name box, type the name of the emulator as it is 
known on your network. 

4. In the Symbolic Name box, type a name you can use to 
identify the emulator. 

Note that the Symbolic Name is used by the connect com¬ 
mand. The S 3 nnbolic Name provides easy way to label the 
different communications configurations. For example, for 
Ethernet communications, you can use the host name of the 
emulator as the Symbolic Name. 

5. Chck OK. 


SuperTAPSXX 
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Making a connection 

The emulator you connect to must support the connection type 
you have selected. Be sure the emulator is on and is configured 
properly. If you disconnect firom one emulator during a debug 
session and connect to another, the emulators must have the 
same type of processor, the processor you selected using the 
Startup Options Editor. 

>- To connect to an emulator 

1. In the Connections window, double-chck to select an 
emulator. 

2. Click the Connect button. 

An asterisk (*) appears in the CON column when you are 
connected to the emulator. The name of the connection ap¬ 
pears in the title bar of the Command window. Status infor¬ 
mation appears in the Command window. 


Connection status 



Figure 2-4 Command window showing connection [frazzle] 


Connect—^ 
Disconneci 



TIP: You can drag and drop the Coimect button from the tool 
bar on an emulator in the Connections window. 
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Configuring the emulator and debugger 

Once you’ve connected to an emulator, you can configure the 
debugger and emulator options. For a brief description of the 
options you can set, see “Configuring the emulator” on 
page 2-12. 

Saving a connection 

Once you have defined and connected to an emulator, you can 
save the connection and configuration to a startup include file. 
When you have a startup include file (STARTUP.INC), 
MWX-ICE automatically connects to the emulator and 
configures the emulator options you have set. 

>■ To save a configuration to STARTUP.INC 

1. From the Displays menu, dioose Emulator Configuration. 

2. In the Emulator Configuration window, choose Save to 
Startup from the File menu. 

By default, your connection and configuration data are 
saved to C:\ST8XX\STARTUP.INC. 

3. If the file exists, a prompt appears asking if you want to 
overwrite the existing file, or replace the configuration 
section of the existing file. 

■ Choose replace if you have added commands to an 
existing startup file. (See “Adding commands to the 
startup file” on page A-5 for procedxures to add 
non-configuration commands to a startup file.) 

■ Choose overwrite if you don’t want to keep the existing file 
or any commands you’ve added. 


The Save to Startup command saves the configuration to 
whatever file you specified at start up. If no file was specified, 
MWX-ICE uses the default STARTUP.INC file. If this file 
doesn’t exist, MWX-ICE asks if you want to create it. 




>~ To save a configuration to another file 

1. Switch to the Emulator Configuration window. 

2. From the File menu, choose Save to File. 

3. Specify the path and filename. 

4. Save your configuration to a new startup file. 


Configuring the emuiator 

Once youVe connected to an emulator, you can configure the 
debugger and emulator options. To set the options, open the 
Emulator Configuration window and click the button for the 
group of options you wish to set. 

The configuration dialogs show the current settings for the 
options. Use the menus or text boxes to change the settings, 
and then choose the Apply button. For information about the 
options in the configuration dialogs, click Help. 



Figure 2-5 Emulator Configuration window 
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You can use the Emulator Configuration window to view and 
modify the options that control the state of the debugger and 
emulator. 

Connections 

The Connections button brings up the Connections window. 
Use this window to define and connect to emulators, and to 
reload the emulator operating system. The Connections 
window is shown on page 2-10. 

Execution 

The Execution button opens the Execution configuration dialog 
box. Use this dialog box to set the emulator execution options, 
such as instruction show cycles, isolation mode, and real-time 
operation. 


CPU Clock buffered tio tiargeb (BCLOCK): 

Xxecu&ion/Access Breekpoizxc Type <BPTYPB): 

Bus Timeouc Bzieble <BTB): 

Clock Frequency in Hz (CLOCK): 

DPI Clock (DPICLK): 

Isoletiion Hodc (ISOHODB): 

Realbine Xnforcenenb (RTS): 

Runcine (secs) (RUH_TZH1): 

Polling Frequency^ per sec (RUH^POLL): 

Control serialization of CPU core (SIRIAL_CORS>: 
Instruction show cycle IB (SHOVUTST) : 

Stop in Target scratch buffer address (SIT): 
Stop-in-target state (SITSTATS): 

Target connection mode (TCTHODB): 


Enabled ^ 
CHOOSE^ 


Enabled 


3 


6.2S 

habled ^ 
iBisabled^Jl 


IMDIRECT 




FULL ICE ▼a 


Apply 11 Restore Val\ie~~| { Cancel | { Help | 


Figure 2-6 Execution configuration dialog box 
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Trace 

The Trace button opens the Trace configuration dialog box. Use 
this dialog box to set emulator trace collection and display 
options. For information about capturing and viewing trace, 
see Chapter 5. 




HHHHEll 

-COLUCTIOT- 1 

Syszmm. (TRSYS): 

|snabled ^ 


Collttccion <TIULCR): 

jBxiabled 


Collsccion S«ac« Run <TRIKIT): 

1 Remain in Currene 

Srare 

Clmmr Buffer Mt Run (TRRUKCLR): 

jAccumulace crace 

"3 

Colleccion Qxxnlificenion (TRQIULL); 

1 Cycles Heeded for Disassembly 

Cnpt^ur* Peeks/Pokes (PPT): 

jDisabledjJ 


Tine scaap clock rick (TIHCLK): 

|40 nS J 


Ixremal rrace cycles (TRCIXT): 

jlaabled jJ 


Frames in Buffer <TRFRAB1S): 



- DISPLAY - 1 

Display Specified Dara (DRTDATA): 

[Byres Used 


Display Specified Fields (DRTFULL): 

|aii fields 

—3 

Display of branch labels in disassembled rrace (DXLABILS): 

[Enabled ^ 


- COHKAHD WIHDOK OUTPUT CONTROL - 


Display Kode (TRDISP): 

[Borh J 


Incerleave Raw in Disassembly <DXIHSSRT): 



Timesramp Base Frame (TRBASS): 

1“ 


How Timesramps are Displayed <TRSTAHP>: 

[offser from Base 

S 

ill 

11 Apply 11 Resrore Value 11 Cancel j | Help | 




Figure 2-7 Trace configuration dialog box 
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Memory 

The Memory Read/Wiite button opens the Memory ReadAVrite 
dialog box. Use this dialog box to enable overlay memory, and 
to control access to overlay by external bus masters (Isolation 
of overlay read/write). 

The Memory button opens the Memory configuration dialog 
box. Use this dialog box set memory access attributes. For 
information about using the emulator's overlay memory, see 
Chapter 3. 





^ Hcmory Verify: 

S3 

Ragistar Varify: 

^ Overlay Sysc.«m: 

jlnablad ^ 


^ Isolation of ovarlay: Raads: jpn 

Vrit^as: jon 

5; 



^ j i ippiy 11 Ras^ora Valua 

Ic^ai llHaip] 



Figure 2-8 Memory Read/Write configuration dialog box 
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Event 

The Event button opens the Event configuration dialog box. 
Use this dialog box to set the emulator event system options. 
For information about using the event system, see Chapter 7. 


^ (VJ 

mwx-’icestSEO 

- Event 

Event Sfjstm (EVTSYS): 

I Enabled o 

1 

Group; 

li g i 


Signal group A nux selection: I IRQ C0:l;7] i 

B] 

Signal group B nux selection; I IRQ C2-B3 o | 

State: 

n~5i 


Counter • 

Value 

Initial Value 

1; 

EZZl 

jUse Current Value at Run ca | 

2; 

10 1 

i Use Current Value at Run a 1 

Onchip Counter • 

Value 


A: 

l» _I 


B: 

IZIZ3 



^ IftpplMl {Restore Value j fCaricell iHelpI 


Figure 2-10 Event configuration dialog box 


File Handling 

The File Handling button opens the File Handling 
configuration dialog box. Use this dialog box to specify the 
upload and download format for non-ELF object files, and to 
other download options. 


Max l^ites Between Download Blocks; 17*****^! 
Download Fornat; jSrecord cTI 

Upload Fornat; j Srecord al 


Figure 2-11 File Handling dialog box 
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Debugger Options 

The Debugger Options button opens the Debu^er options 
configuration dialog box. Use this dialog box to set input and 
output radix and other debugger options. 


^ Izi mwx-icestSGO - Debugger Options ] 

Align Instruction Breakpoints: 

j On O 1 

CPU Type: 

{HPCSSO 1 

Input Radix: 

{Decimal O 1 

Output Radix: 

i Decimal ca | 

Source Lines In Assenbly: 

IQr. d| 

Echo Include File Coiwands: 


Show Synbols in Assembly: 

1 On o 1 

Type Checking: 

lOff a 1 

Benand Loading: 

|0n o| 

Use Animated Cursor: 

1 On a { 

Load Options: 


1 lApplyl {Restore Value! {Cancel 1 {Help! 1 




Figure 2-12 Debugger Options dialog box 


Other things to do at startup 

□ Map any overlay memory needed. See Chapter 3 or Help for 
procedures. 

□ Download target code to overlay, if needed. See Chapter 3. 
You can use the Startup Options Editor to enter the name of 
the absolute file to load. 

□ Once youVe started the emulator and debugger, you need to 
initialize the processor using the reset command, then you 
can begin emulation. 

□ Set up the initialization registers. These registers provide a 
way of decoding the multiplexed control pins, disabling the 
software watchdog timer, and making MWX-ICE memory 
operations possible immediately after a processor reset. See 
‘TJsing the set of initiahzation registers” on page 8-2. 
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Isolation mode 


The debugger provides two operational modes: in-target and 
isolation mode. If you have no target to connect to or the target 
is unreliable, you can run in isolation mode using the probetip 
processor and downloading target code to overlay memory (if 
installed). The system automatically enters isolation mode at 
startup if no target Vcc is found; so no special setup is required. 


Note 



Special procedures do apply if target Vcc is lost and isolation 
mode is entered after startup. See “Support for target power 
loss” on p^e 2-24. 


You can enter isolation mode by enabling the isolation mode 
option in the Execution Configuration dialog. To enable this 
mode, open the Execution Configuration dialog firom the 
Emulator Configuration window. You can also use the 
isomode softswitch in the Command window. 

The isomode softswitch controls the operational mode. The 
internal default is in-taiget mode (isomode off). Use of the 
isomode softswitch is described in Help. 

If you use isolation mode, you need to consider the following: 

□ Whenever isolation mode is enabled, the emulator does not 
use the target, even if one is connected. If the emulator fails 
to find a connected target, check the setting of the Isolation 
mode option in the Execution Configuration dialog. Make 
sure that it is disabled, and then save your configuration to 
the STARTUP.INC file. If the target still is not found, or if 
the emulator shifts to isolation mode, check target power. 

□ When connected to a taiget with isomode on, all signals 
between the tajget and probetip float. If your target cannot 
tolerate floating lines, disconnect it from the probetip when 
isomode is on, or always keep isomode off. 

□ During times when you wish to emulate and debug in a 
targetless environment, it is a good idea to enable the 
Isolation Mode option, and then save your configuration to 
the STARTUP.INC file. 


SuperTAP8)a 


2-19 




What happens at power on, reset, and restart 

When you turn power on to the SuperTAP emulator and start 
the MWX-ICE debugger, two parallel processes begin. On the 
emulator side, the controller runs PROM-based diagnostic and 
boot code. During this process, the hardware installed in the 
emulator is polled and its hardware configuration stored for 
future reference. 

On the host side, the AppHed Microsystems debugger queries 
the SuperTAP for its state and configuration. If the emulator 
reports itself in a power-up state, the program checks for the 
presence of the emulator control shell and downloads it, if 
necessary. 

When the control software completes its configuration and is 
running, the emulator’s state changes to “Ready,” and the 
control software is ready to run. 

The following describes each portion of the process in detail. 

Emulator power-on sequence 

The following sequence of events occurs when you turn on 
power to your SuperTAP emulator: 

□ The emulator controller runs PROM-based diagnostic and 
boot code. 

□ The controller board is initialized. 

□ The configuration stored in the SuperTAFs flash memory is 
read. 

□ The emulator starts the emulator control software, if it is 
loaded into flash memory. 

□ The emulator is reset to a known state. 

□ The breakpoint, event, trace, and overlay systems are 
cleared and initialized. 
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Emulator control program startup 

When you start MWX-ICE, the following events occur: 

□ The host opens the startup.inc file (if it exists) and loads the 
connection and configuration parameters. 

□ The host screen and search paths are initialized, the 
emulcfg.dat database is opened, and the host-emulator link 
is initialized. 

□ The emulator interface layers are initialized and opened. 

□ The emulator is reset to a known state. 

□ The breakpoint, event, trace, and overlay systems are 
cleared and initialized. 


Debugger reset 

The reset command allows you to regain control of your target 
and re-synch the emulator with it. It is required to recover from 
timeout errors. 

What happens when you use the reset command 

When you execute reset from the command line, the emulator 
performs the following: 

□ Asserts HRESET to reset the processor on the SuperTAP. 

□ Restores the SuperTAP logic to a known state. 

□ Preserves memory mappings and other emulation settings. 

□ Processes the initialization registers (if initregs is enabled). 

The reset command does not re-initialize memory; variables 
are not reset to original values. Use the load or reload 
commands to restore variables. 

If this command is issued while the emulator is in drun mode, 
emulation stops before execution of the command. 


SuperTAP 8XX 
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Program restart 


If the symbol table is loaded, restart resets the program 
counter and stack pointer to the or^nal starting address from 
the absolute file. The next time you go into run, execution 
restarts at the beginning of the program. Breakpoints are not 
cleared, variables are not reset, and any declared I/O ports still 
exist as originally specified. 


Emulator reset 

In rare situations, you may have to reset the SuperTAP to 
restore tiie system to a known state. 

>- To reset the SuperTAP 

1. Exit the debugger. 

2. Push the toggle switch on the back of the emulator to the 
reset position. 

3. Restart the debugger. 

What happens when you press reset 

When you press the reset switch, or cycle power, the following 
sequence of events occurs in the emulator: 

□ Startup diagnostics are performed. 

□ Communication parameters are loaded from the system 
core, and the appropriate Ethernet protocol is used to 
establish communications across the network. 

□ The SuperTAFs flash memory is checked for the presence of 
a transaction shell. 

If no shell is foxmd, the transaction shell is downloaded from 
the host to the SuperTAP. 

If a shell is found, it is started, the target processor is reset, 
and the emulator enters pause mode and waits for connec¬ 
tion with the debugger. 
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During the reset process, the SuperTAP enters isolation 
mode if the emulator is not connected to a target, or if no tar¬ 
get power is detected. 

During the reset process, DPI-only or full emulation mode is 
selected based on whether power comes from the DPI cable, 
or the target. From MWX-ICE, the tgtmode command 
shows which mode is selected. 

Software watchdog timer 

The MPC8XX has a software watchdog timer (SWT) that is 
enabled after a S3retem reset to cause a system reset when it 
times out. If you don’t plan to use the SWT, you must clear the 
software watchdog enable bit (SWE) in the system protection 
control register (SYPCR) to disable the timer. 

Because the SWT is enabled after a reset, you can use the 
SuperTAFs initialization registers (initr^s), to 
automatically disable (or configure) the timer after reset. This 
way you won’t have to run your boot code or manually configure 
register after each reset operation. If you are not using 
initregs, the SWT times out every four seconds and resets the 
processor. 

To avoid this problem, you must enable the initialization 
registers (initregs on), and save then initialization registers 
to a file. 

For information about setting up the initialization registers, 
see “Using the set of initiaUzation registers” on page 8-2. 
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Important operational notes 

This section presents various characteristics of the emulator 
and debugger that you should be aware of during emulation. It 


includes: 

Contents Page 

Support for target power loss 2-24 

Isolation mode 2-24 

Peek and pokes during pause or run 2-25 

Show cycles 2-26 

AC timing 2-26 

Alternate bus master 2-27 

Recoverable interrupts 2-27 

Support for the MMU and logical addressing 2-28 

Support for target power loss 


Target power is monitored. An 3 ddme an operation is attempted 
when VDDH, VDDL, or KAPWR not present, an error is 
generated. 

With the emulator installed, only approximately 1 mAis drawn 
from target VCC through the CPU socket. Note that this is 
substantially less than the current drawn by an actual CPU. 


Isolation mode 

An emulator softswitch (isomode) enables selection of an 
internal clock when target power is lost. 
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Caution 




Keywords: 

ISOMODE 

Vcc 


When the SuperTAP is connected to a target and isomode is 
on, the bus, clock, and power signals are isolated, and all CPM 
signals are connected to the target. You should always 
disconnect the SuperTAP from the target when isomode is on, 
or always keep isomode off. 


Loss of power during run 

If target power is lost while the emulator is running, MWX-ICE 
issues a warning message. Whether power remains off or is 
restored, the emulator remains in run and maintains 
emulation unless the Stop button is cHcked. Stopping while 
power is lost may cause corruption of code, even in overlay, 
because breapoints can’t be removed. 

Loss of power while in pause 

If target power is lost while the emulator is paused, MWX-ICE 
issues a warning message when you next enter a debugger 
command. 

A target reset is forced whenever target power is restored. 


Peek and pokes during pause or run 

Peeks are reads, and pokes are writes performed during pause. 
These may occur as a result of event system activity (reading a 
register, incrementing a variable, etc.) or when you look at or 
modify memory while emulation is paused. The tracing of peek/ 
poke cycles is controlled by the ppt command. 
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Various display characteristics 

Several characteristics of MWX-ICE windowing and display 

could cause confusion unless understood: 

□ During high-level single-stepping, the highlight bar seems 
to jump randomly from line to line in the Code window. This 
is correct behavior usually resulting from highly optimized 
code. 

□ Error dialog boxes are scrollable. Occasionally, it is 
necessary to scroll up or over to view the entire message. 


Show cycles 

The SuperTAP is designed to operate even when you are using 
the processor instruction and data caches. The SuperTAP trace 
system requires that the processor instruction show cycles are 
enabled. In most cases, you only need to generate show cycles 
for indirect branching. The MWX-ICE showinst command 
controls processor show cycles. The default setting is for 
showinst is indirect. Enabling show cycles for indirect 
branching only adds a minor performance penalty to the 
processor execution. But this is hundreds of times better than 
the performance hit you take for disabling caches. The 
serial_core command controls processor serialization. In most 
cases, you won't need to serialize the core to be able to trace 
execution or use the event system. For more information on the 
showinst and serial^core commands see Help. 


AC timing 

The SuperTAP AC signal timing is exceptionally close to the 
emulated processor. In most cases, it adds only 1 to 2 
nanoseconds to published Motorola timing for external signals 
and should operate well within Motorola worst-case timing. It 
can add 1.8 to 3.0 nanoseconds to the CLKOUT signal, 
depending upon whether you need to add additional buffering. 

Exhaustive measurements to verify calculated worst case 
numbers have not been made. All calculated values assume 
worst-case timing at 40 ^C ambient. Target signals are 
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expected to be properly terminated to avoid reflections. For 
more information about AC timing, see the SuperTAP 
Emulator Installation Guide. 

AC timing specifications are provided by Applied Microsystems 
as general guidelines for customers using our products. These 
specifications are calculated and measured under the 
conditions specified. Because of variations in target loading, 
temperature and device timings. Applied Microsystems does 
not guarantee these specifications. Applied Microsystems 
reserves the right to make changes to these specifications at 
any time without notice. 


Alternate bus master 

The emulation logic is designed so that the monitored address, 
data, and status signals remain valid even when the processor 
has lost the bus to an alternate bus master. This allows the 
trace and event systems to continue to operate during alternate 
bus master cycles. To enable tracing of external bus cycles, 
configure the emulator's trcext variable to on. 

Recoverable interrupts 

The MPC8XX has a bit in the machine state register (MSR) 
called the recoverable interrupt bit (MSRrj). The MSRgj 
indicates whether the interrupt is restartable. If this bit is not 
set, the target CPU may not respond to breakpoints. To the 
processor, a normal, maskable break looks just like any other 
interrupt/exception. 

For example, if you want to set a breakpoint at the beginning 
of an interrupt service routine, you need to ensure that the 
recoverable interrupts are enabled, and that the madiine 
status save/restore registers (SSRO/SSRl) are correctly 
written. 
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To handle exceptions, your interrupt service routine must do 
the following: 

1. Save the SSRO and SSRl registers to memory. 

2. Set the MSRri bit. 

3. Execute any exception processing. 

4. Clear the MSRri bit. 

5. Restore the SSRO and SSRl registers. 

6. Execute the rfi system call. 

For more information on recoverable interrupts, see the 
Motorola MPC8XX User's Manual, 

Support for the MMU and logical addressing 

The SuperTAP provides support for the memory management 
unit of the MPC8XX. Prior to any emulator action, a valid 
translation table must be loaded into memory before the 
instruction or data MMU is enabled. 

All logically addressed user input (breakpoints, overlay maps, 
etc.) is translated to the corresponding physical addresses 
before being apphed. During nm, the system uses the 
translation tables to perform logical-to-physical translation 
dynamically. 

Address translation 

Every fimction of the emulator and debugger supports logical 
code, logical data, and physical addressing. As long as vaUd 
translation tables are loaded into memory, the SuperTAP 
emulator can automatically translate logical addresses to 
physical. The xlate utility provides the means for manual 
logical-to-physical translations. 

To indicate whether the default addressing mode is logical or 
physical for the many key functions of the debugger, use the 
Memory Configuration dialog box (see Figure 2-1), or the 
matrix provided by the address command. Each row identifies 
a type of memory activity performed using a specific command 
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or feature of the debugger. The setting for each specifies how 
the debugger should interpret subsequent address input it 
receives. If incorrectly set to logical, these settings may cause 
commands or features affected by them to function 
unpredictably or cause exceptions. 

In some cases these defaults can be overridden individually. 
For example, the event system field (event) is applied only if 
no overriding qualifiers are specified in the when inputs. In all 
other cases (ba, bi, etc.), you can toggle the setting prior to 
individual command input to change the addressing mode for 
the following entry. The startup.inc file can be used to set 
defaults at startup. 

Regardless of the mode of user input, the system uses physical 
addressing during operation. 
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Figure 2-1 Memory configuration dialog box 
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Table 2-1 Address matrix of memory qualifiers 


Label 

Sets Default Addressing Mode for 

ACCESS 

Access breakpoints set using ba, br, bw. 

ASM 

Entries using the asm line assembler. 

AUX 

SIT loop location. 

CODE 

Downloads (load, dnl) and code display refreshes. 

COMPl 

First argument of compare. 

COMPl 

Second argument of compare. 

COPYFROM 

Source of copy action. 

COPYTO 

Destination of copy action. 

DIAG 

Memory tested by diagnostic routines (requires physical) and crc. 

EVENT 

Any event system address entries. 

EXEC 

Execution breakpoints set with bi, high-level step and Breakl. 

HLL 

Memory to be modified by fill. 

READ 

Reads using dump, upl, disassemble* 

SEARCH 

Memory locations specified in search. 

STACK 

Stack display and refresh. 

TEST 

Memory accessed by test. 

WRITE 

Writes using setmem. 

XLATE 

Address translations using xlate. 
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Mapping logically addressed memory in overlay 

When you map a logically addressed range to overlay memory, 
the following occurs: 

□ The system translates the start addresses to a physical 
address. 

□ Using the length specified in the map range, it maps overlay 
memory as a continuous block. 

For this reason, the logical and physical memory must map to 
contiguous physical addresses. Chapter 3 explains overlay use 
and describes procedures and limitations when using logical 
addressing. Overlay addresses are always displayed as 
physical values. 

Copying using logical addresses 

One special consideration appHes when you request a copy 
within target or overlay memory, rather than between target 
and overlay. 

The copy function of the debugger relies on the assumption that 
source and destination logical memory translates to contiguous 
blocks of physical memory. In the unli ely event that this is not 
the case, there is a chance that the source range can be 
overwritten before all necessary reads are performed. 

Once it translates the source and destination start addresses, 
the debugger requests new translations during the copy only at 
large boundaries. If the imderlying physical memory for the 
range is not contiguous, it is possible to overwrite the source 
range before it has been read, and then copy this incorrect data 
to the destination range. 

Addresses in displays 

Except for disassembled trace and any logical address showing 
in the raw trace for the Instruction Pointer, the debugger 
displays addresses in physical addressing mode, regardless of 
the addressing mode used for address entry. Consequently, you 
should xmderstand the logical-to-physical mappings for ihe 
memory you are debugging. 
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Raw trace This trace shows any logical address for the IP 
and uses physical addressing in the remaining display. This 
includes raw trace interleaved with disassembled trace. 

Overlay map The listings of mapped memory use physical 
addresses. 

Operational considerations 

If you plan to attempt workarounds for table and paging 
methods not supported during run, there are several 
considerations to bear in mind: 

□ If during operation your code changes memory translation, 
you must structure your debugging session to deal with one 
translation table at a time. The emulator cannot 
automatically disable breakpoint, event, and other 
address-dependent configurations that would no longer 
apply when a new translation takes effect. For example, any 
overlay mapping must be adjusted and appropriate code 
loaded into memory. 

□ If two or more logically addressed elements share the same 
physical address, there is the chance of unpredictable 
emulation behavior. The emulator converts all logical 
addressing to the corresponding physical address. The 
possibihty exists that a breakpoint or event comparator 
would cause a break or other action at an unintended point 
during operation. 
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Chapters 

Using Overlay Memory 


During development and integration, you often need stable 
memory to replace or extend actual target memory. The 
optional overlay features of the SuperTAP emulation system 
provide these capabiHties. 

This chapter provides information about overlay procedures, 
use, and related topics. 


Contents Page 

How overlay is used in debugging 3-2 

Features and important characteristics of overlay 3-3 
How memory mapping is handled 3-6 

Basic procedures for mapping overlay 3-7 

Mapping physical memory 3-10 

Mapping overlay using logical addresses 3-12 

Warnings and error mess^es 3-14 

Loading code and copying memory 3-15 

Controlling the source of accesses 3-18 

Additional information 3-19 

Using Help 


The information presented here supplements the related 
overlay topics found in the Help. You may wish to have Help 
running while you read this chapter. Where applicable, the 
releva nt keyw ord search term is included in a marginail 
callout jsearchl . 


3-1 





How overlay is used in debugging 

Overlay has four typical purposes: 

□ Provide a substitute for target memory during early 
integration when target memory is not operational. 

□ Offer a stable substitute into which to load code and test 
against target operation. 

□ Replace the ROM on the target, enabling you to patch on the 
fly without recompiling, rather than continually burning 
new PROMs. 

□ Extend target memory temporarily to hold test routines and 
code expansion beyond ROM and RAM limits. 

Typical process 

1. Set memory configuration or use the INIIREGS feature. 

2. Map the memory regions to overlay. 

3. Copy the PROM contents or load code into overlay. 

4. Run to a breakpoint or event condition. 

5. Examine trace. 

6. Use the line assembler to patch and retest without 
recompiling, even in ROM space. 

7. Upload patched object code to host for re-use. 
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Features and important characteristics of overiay 

Overlay memory is physical memory provided by the emulation 
system. It can be mapped into the target system’s memory 
space and programmed to respond as if it were target system 
memory. This means you can replace high-speed target 
memory subsystems with comparable overlay during 
debugging. 

The custom features provided by the SuperTAP emulator are 
summarized below. 


Overlay options 

The SuperTAP can be equipped with up to 8 MB of overlay 
memory. Overlay memory is available in 1 MB, 4 MB, or 8 MB 
modules. Contact Applied Microsystems if you want to increase 
the amount of overlay in your system. 

Wait states 

Overlay responds to accesses with the following speed 
characteristics: 

□ 0 wait states for 25 MHz bus speeds 

□ 1 wait state 50 Mhz bus speeds. 


3 


Overlay functions correctly in regions configured with 32-, 16-, 
or 8-bit port sizes. 

Termination _ 

When a memory bank is configured for external TA generation, 
(the SETA bit in the chip-select option register), the target 
must assert the TA signal even if the memory bank has been 
mapped to overlay memory. In the case of isolation mode 
(isomode on), the SuperTAP overlay system will supply one 
wait state TA. 
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Using Overlay Memory 




Keywords: 

MAP 


128K minimum granularity 

Overlay memory can be mapped an 3 where in logical or 
physical memory in ranges as small as 128K The mapper 
automatically adjusts non-conforming ranges to match grain 
requirements and aligns ranges on 128K boundaries. This is 
explained in "How memory mapping is handled’' on page 3-6. 

Qualification by access type 

Each mapped range can be qualified as read-write, read-only, 
write-only, or restored to target memory. 

Address translation 

Overlay can be mapped using physical or logical code or logical 
data addresses. The mapper performs a logical-to-physical 
translation and uses physical addresses for all subsequent 
operation. Listings of overlay mappings are presented as 
physical ranges. 

User Programmable Machine (UPM) A and B 

Because of the complexity of address multiplexing, the 
SuperTAP is not able to map overlay memory to target memory 
that uses the UPM. The UPM is typically used to access target 
DRAM. If you want to map overlay memory to those regions 
where target DRAM is not functioning, you can reconfigure the 
UPM regions to use the general purpose chip-select machine 
(GPCM) instead. The GPCM is normally designed to be used 
with EPROM, ROM, and SRAM type devices. But you can 
switch the UPM regions to GPCM by changing the machine 
select (MS) bits in the chip-select BRx registers. 

Parity 

Overlay memory does not support parity. 

External bus master 

Overlay supports accesses by both sjmchronous and 
asynchronous external bus masters. When you want an 
external bus master to access overlay you must set two overlay 
options that control whether reads or writes go to target as well 
as overlay. The commands are ovwritethru on and 
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ovreadthru on. To prevent contention, you must also make 
siire that any tai^et ROM device that is overlayed is 
deactivated. 



Rgure 3-1 Overiay memory configured for external bus master 


Keywords: 

Maplist 

Inciude 


Saving and restoring overiay maps 

To enable recreation of debugging conditions, the maplist 
command saves current mappings as a command file that can 
be restored using include. 

Note that overlay memory retains its content even if target 
power is lost. 
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How memory mapping is handied 

This section summarizes the rules governing overlay function 
and use. To make effective use of overlay you should 
understand these basic principles. 

If you want a more extensive explanation, these principles are 
fiilly illustrated in the three extended examples later in this 
chapter: 

□ Mapping physical memory 

□ Mapping logical memory 

Mapping overlay is the process of requesting an overlay 
location for memory address ranges and their attributes. You 
use the map command to make these assignments, and 
mapclr and maplist to clear or display the current mappings. 

Page allocation is the process the overlay system goes through 
to assign overlay mapping requests to one of the eight pages 
and maintain the integrity of memory accesses. Page allocation 
is determined by the physical address range of the map 
request. 

Page addressing 

Page starting and ending addresses are automatically aligned 
to boundaries corresponding to the page size. For example, the 
following command: 

map 0x30000..OxSlfff 

will cause the overlay mapper to display a warning message, 
and then allocate a page of overlay to the 128K range 
Qx20000..0x3ffEf. 

maplist 

MAP 0x00020000..0x0003FFFF=RW 
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Each mapping that falls outside a previously estabhshed range 
causes allocation of new overlay pages until the overlay 
resources are exhausted. 

This processes is illustrated in detail in “Adding ranges to 
overlay** on page 3-10. 

Characterizing additional attributes 

If logical addressing is used, the logical range is converted to a 
physical range using the translation tables present in tai^et or 
overlay memory. Full procedmes and an illustration of 
mapping to logical addresses are provided in “Mapping overlay 
using logical addresses” on page 3-12. 

Each individual range can be quaUfied to respond as read-write 
(rw), read-only (ro), or returned to target (target). Different 
access types can be located in the same bank of overlay. 


Note 



Overlay is designed to block taiget writes to read-only overlay 
during run. It does not halt emulation. To break on such illegal 
writes, set an access breakpoint over the range in question. 


Basic procedures for mapping overiay 

This section summarizes the procedures for typical overlay use. 
Extended examples follow and highlight special considerations 
and operational characteristics. Command descriptions and 
many of the procedures are also provided in Help. 


Q ualifyi ng mappings for addressing mode 

Isearohj Keyyyopds: The debugger defaults to physical addressing mode. Use the 

Space mode option of the map command to override the defaults for 

a single mapping. 


Address 
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This procedure is covered in detail in the extended examples of 
mapping with logical addresses. 


Adding an overlay mapping 

Overlay mappings are entered from the command line using 
the map command line to enter either logical or physical 
address ranges: 


Keywords: 

MAP 

Addressing mode 
Overlay access 
types 


■ Enter the address range and attributes of the mapping: 

map start..end | start, .+length [,mode] 

[ = type] 

For full procedures and command line options, see Help. 


Modifying an existing overlay mapping 

Overlay mappings are modified by re-mapping the existing 
range with its new attributes. In all cases, the new mapping 
replaces the previous one. If they overlap, the portion of overlap 
takes on the new attributes, but the overlay contents are 
maintained. 


Restoring memory to target 

Convert overlay mappings to target memory using the map 
command with the =target option. 

> To restore memory to target 

1. Use maplist to select the mapping to restore to target. 

2. On the command line, enter the Hsted range or base plus 
length, and assign it to target: 

map { start . , + length \ start., end} =target 

3. Click Enter Command, or press <Retum>. 
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- 1 If you use logical addressing, you can also enter the original 

Keywords: logical range. The mapper will translate it to physical and 

MAP restore control of the appropriate physical range to target. 

MAPCLR 

Target memory 

Displaying/saving/restoring memory map 

Use the maplist command to display the current mapped 
memory or to save that listing for future use. 

>- To display the current memory mappings 

■ From the Command window, type maplist 


Keywords: 

MAPLIST 

Include 


The current mappings display in the Command window. All 
mappings originally entered as logical ranges are displayed as 
their physical equivalents. 


> To save current mappings to a file 


■ Type maplist 


If you plan to use the file as a command file, give it an .inc 
extension. The current hsting of physical ranges is saved to the 
named file in the current working directory. Provide a full path 
if you want to save it elsewhere. 

> To restore a previously saved map file 

■ Use the include command to reload fUenameJmc 
—or— 

■ At MWX-ICE startup, use the include option in the 
MWX-ICE Startup Options Editor to load filename.inc. 

This restores the physical memory map. 

Clearing the overlay memory map 

Keywords: Use the mapclr command to clear all memory mappings and 

MAPCLR return memory control to the target. 
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Mapping physical memory 

Many target designs employ physical addressing, rather than 
logical. This section illustrates how overlay is enabled for such 
a system and how memory resources are allocated. 

Scenario 

An example region of target memory has a physical base 
address of 0x8000 and a length of 32K (0x8000). Of the several 
modules located in this region, the module you are interested 
in starts at 0x90c4 and ends at 0x9fdf. 

Procedures 

■ Map the range: 
map 0x90c4..0x9fdf 

The following occurs when you enter this mapping in a 1 MB 
overlay system: 

□ An entire 128K bank of overlay is allocated, starting at 0x0. 
Q Because neither the start nor the endpoint falls on a 128K 

boundary, the overlay mapper adjusts the range to 
0x00000000..0x0001FFFF and warns that it has done so. 
Problem found while configuring overlay memory. 

The Overlay Map request starting and/or ending ad¬ 
dresses were adjusted to a 128K byte boundary. Over¬ 
lay can only be mapped to 128K byte regions. Display 
current overlay mapping to see the adjustments made. 

□ The 128K range is enabled to respond to read-write accesses 
(the default). 

Adding ranges to overlay 

Although one 128K bank of overlay is allocated, you still have 
896K of overlay memory available. You can add additional 
address ranges to overlay. Both read-only, write-only, and 
read-write mappings can co-exist within overlay memory. 
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For example, if you wanted to map over taa^et ROM, located at 
0xl00000..(>x00103CD0, you could add the following command: 

map 0x100000..+0xlffff=ro 

The new mapping would be adjusted for boundaries, and 
enabled adjacent to the initial one in the same bank. Amaplist 
display of mappings would show: 

maplist 

MAP 0x00000000..0x0001FFFF=RW 
MAP 0x00100000..0x0011FFFF=RO 

Overlapping requests 

The mapper constantly re-evaluates mapping requests, 
consolidates overlapping or adjacent mappings, and adjusts 
boundaries. When a new mapping overlaps an existing range, 
the portion within the overlap takes on the attributes of the 
new mappings. 

For example, a routine might be located from 0x10000 to 0x2ffif 
in read-only memory. If you add this new mapping 
(map Qxl0000~0x2fGEf=ro) to the ones above, the maplist 
shows the following: 

maplist 

MAP 0x00000000..0x0003FFFF=RO 
MAP 0x00100000..0x0017FFFF=RO 

Because the new overlay segment overlaps an existing one, and 
also cuts across the 128K minimum map size, two 128K 
segments are mapped as read-only (0x0..0x0003FFFF). 

Now, if you map the lowest 128K as read-write memory, notice 
how the attributes change again. 

map 0x0..Oxlffff=rw 

maplist 

MAP 0x00000000..0x0001FFFF=RW 
MAP 0x00020000..0x0003FFFF=RO 
MAP 0x00100000..0x0017FFFF=RO 
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Mapping overlay using logical addresses 

This section explains and illustrates how overlay is allocated 
and enabled for a target system that use the memory 
management unit and logical addressing of the processor. 


Note 



For a system-level discussion of logical addressing and MMU 
support, see “Support for the MMU and logical addressing” on 
pj^e 2-28. Relevant portions of that chapter are expanded here 
for their application to overlay use. 


Required target configuration 

Before requesting overlay mapping using logical addressing, 
the target must meet certain requirements: 

□ Valid translation tables must be in memory before the 
instruction or data MMU is enabled. 

□ The MMU must be initiahzed. 

Valid translation tables 

Tables must be in memory before mapping can begin. 

Initialized MMU 

During mapping, the memory management unit must be 
initialized and translation tables must be loaded into memory 
before the mapper can perform logical-to-physical translation 
and enable regions of physical memory. The MSRjr or MSK^r 
bits must be configured to enable MMU translation. 
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Memory map 

The mapper uses ihe following method during translation: 

a The MMU is queried for the physical location of the logical 
starting address. 

□ The length of the mapping is inferred from the logical range 
entered. 

□ The request is adjusted to meet overlay granularity and 
alignment requirements. 

□ A continuous block of overlay is enabled beginning at the 
ph3%ical starting address and extending for the length of the 
range. 


Note 



If you don’t know whether logical ranges translate to 
contiguous physical ones, or if logical to physical translations 
are readily available, use physical ranges when mapping 
overlay. 


Understanding and using the maplist displays 

The maplist displays the physical ranges created when the 
mapper translates the logical input. Consequently, you should 
understand the logical-to-physical mappings for the memory 
you are overlaying. 

To keep track of how the mapper translates and adjusts the 
logical ranges to fit overlay granularity requirements, you can 
activate the log utihty and capture the maplist reports as you 
make each entry: 

1. Turn on the log utihty, configured to log output to a file: 

log /a on="ovlinap" 

The /a filter appends successive output to the file. 

2. Enter a map request. 

3. Enter maplist. 


SuperTAP 8XX 


3-13 




4. Repeat 2 and 3 until all memory is mapped. 

5. Open a new shell and display the file, or print it. 

Like maplist files, log files can be edited and used as 
command files to re-map overlay. 


Warnings and error messages 

The overlay mapper automatically adjusts the start/end points 
of each map request to force them onto 256-byte boimdaries 
and to adjust the bank's start/end points to make most efficient 
use of overlay resources. 

The mapper prompts you when a mapping cannot be completed 
as requested and warns you when it makes changes to the map 
request you have entered: 

^Incorrect syntax • ♦ JSymbol not found^: You have 
mis-keyed the entry or used illegal S 3 mtax. 

^Overlay request endpoints adjusted^: Each overlay 
mapping is adjusted to begin and end on a 128K boundary (0x0 
and Oxlffif) and to span an appropriate multiple of 128K 
ranges. 
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Loading code and copying memory 

The map command simply defines where memory accesses 
take place (target is the default) and assigns access type 
attributes to the memory region. You use load or dnl to load 
code into target or overlay memory, and upl to save the 
contents of target or overlay to a named file on the host. The 
overlay and copy commands enable you to copy the contents 
of memory between target and overlay. 


Downloading code in 

Keywords: 

LOAD 
Fiie format 


ELF/DWARF format 

If your object code is in ELF/DWARF format, choose Load from 
the File menu, or use the load command with the Command 
window to download to target and overlay 


load demo\ cdemon. el f 


Depending on any overlay mapped, this routes code to 
appropriate overlay and target memory locations. Filters are 
provided to select whether to load symbols, set the program 
counter, append to exiting code, etc. 


Downloading other formats 


'SMixh'l 


Keywords; 

DNL 

Fiie format 
DNLFMT 


If code is not in ELF/DWARF format, use the dnl command to 
download. You can use the dnl command to download a hex file 
from the host to the tai^et in the format specified by the 
dnlfrnt command. Before downloading, memory must be 
quaUfied using the code field of the address and space 
commands. 


For example, to download an S-record file named main.srec 
using physical addressing: 

address code physical 
dnlfmt srec 
dnl "main.srec" 
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Note 



When dnl and upl are used, the file being transferred acquires 
the object format specified by dnlfint or upljfint 
(S-Record is the default). Debugging with symbols is supported 
only for ELF/DWARF format. 


Stopping a download 

If for any reason you decide to stop a download while it is in 
progress, click the Stop button. 


Copying memory contents between target and overlay 

The contents of overlay and target memory may be copied in 
either direction to identical or different memory locations. The 
following procedures are most useful when you need to copy the 
contents of your target ROM or PROM into overlay memory for 
patching, to avoid having to bum a new ROM. 


Keywords: 
OVERLAY 
Command 
Copying memory 
COPYTO, 


Specifying source and destination 

Two settings in the overlay matrix, copyfirom and copyto, 
specify source and destination, respectively. The on option 
chooses overlay; off selects target. 


>■ To prepare to copy from target to overlay 

1. Select target as the copyfrom source: 
overlay copyfrom off 

2. Select overlay as the copyto destination: 

overlay copyto on 


3-16 


MWX-ICE User's Manual (Windows) 




Performing the Copy operation 

If you want point-and-click access to the MWX-ICE copy 
functions, use the Copy page of the Memory Commands 
notebook. Otherwise use the copy command from the 
command line of the command window. 


map 0x0..Oxlffff=ro 

overlay copy from off 
overlay copyto on 


Enables overlay memory to 
respond to the specified range as 
read-only memory. 

Specifies target as source of copy. 

Specifies overlay as destination of 
copy. 


copy 0x0 . . 0x1 f f f, 0x0 Specifies target range to copy to 

overlay and overlay starting 
address. 

Saving overlay to a file 

You can save a portion or all overlay or target memory to a 
named hex file using the upl command. The format of the files 
depends on the setting of the uplfint command. Symbols are 
not supported. 


Keywords: 

UPL 

UPLFMT 
Memory access 
qualification 


Before uploading the file, set the memory characteristics using 
the address and overlay commands. Overlay memory does 
not quahfy accesses for size. 

For example, suppose the contents of overlay memory from 
0x..()xffif have the address mode, physical. Enter the following: 


overlay read on 

address read physical 

upl "rnyfile.hex", 0x0..0xffff 
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Controlling the source of accesses 

Normally when overlay is mapped, you want all accesses to the 
mapped region to occur in overlay. To refine and occasionally 
override the memory mappings, use the overlay command. 
For the 14 types of access listed, you can toggle the source of 
access individually from overlay to target. 

ASM Destination of line assembly using ASM 

AUX Location of SIT mode 

CODE Code window display and accesses using LOAD 
cind DNL 

COMPl Source of first argument of COMPARE 
COMP2 Source of second argument of COMPARE 
COPYFROM Source memory for a COPY 
COPYTO Destination memory for a COPY 

DIAG Memory for use with DIAG 

FILL Destination of FILL 

READ Generic reads using DUMP, CRC,UPL, DISASSEMBLE 

SEARCH Memory for use with SEARCH 

STACK Memory accesses for the stack display 

TEST Memory for use with TEST 

WRITE Memory for generic writes (SETMEM) 

The default for each type is overlay (on), imless changed from 
the command line or in the Memory dialog of the Emulator 
Configuration window. If the debugger find no overlay mapped 
for the type of access, it reverts to target. However, if a type is 
set to target (off), the debugger does not access overlay, even if 
it is mapped. 

For example, if you want all diagnostics to run in target 
memory, set overlay as follows: 

overlay diag off 
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Additional information 


□ The tutorial in Chapter 10 offers additional practical 
examples. 

□ Help provides detailed descriptions of all the commands 
mentioned in this chapter, as well as structured “browse 
sequences” that organize the Help topics by subject. 
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I Chapter 4 

Programming Flash Memory _ 

This chapter describes how you can use MWX-ICE and the 
SuperTAP to program, lock, and erase the flash memory in 
your target system. 


Contents Page 

Overview 4-2 

How to program your flash memory 4-5 

Flash memory macros 4-14 
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Overview 


Flash memory is widely used in embedded system designs 
because of its non-volatility, high-performance, low-cost. 
MWX-ICE and the SuperTAP provide a fast and efficient 
means of programing and erasing flash memory devices in your 
target system. When you use the SuperTAP, there is no need to 
use separate flash programing tools, and no need to connect 
additional hardware to your target system. You can protot 3 T)e 
and debug your system design all within the MWX-ICE 
environment. 

Using special flash memory commands, you can config^e, 
erase, program, and lock and unlock flash memory devices. 

To avoid inadvertently writing to flash memory, you can only 
program, erase, or lock one flash memory device at a time. If 
you are programming more than one device, you need to remove 
the existing device, before you can configure the next. 
Removing the device only disables the capabihty of 
programming the device. The actual device and its memory 
contents are not changed in any way. 

Example of a target system using flash 

The example shown in Figure 4-1 shows a target S 3 rstem that 
uses three flash memory components. These are 512Kby 8-bit 
devices. Two of the flash memory components are linked in 
parallel, and are accessed by chip select 0 (CSO), which uses a 
16-bit port. The base address is 0x0. The third flash memory 
chip is located at address 0x80000000. This address is accessed 
by chip select 1 (CSl), using an 8-bit port. 

Programming the flash for this target system requires two 
separate steps. First, you configure and program the devices at 
address 0x0. The two AMD29F040 memory chips are 
configured and programed together. The command to configure 
the device is amd29f040(0x0,16). This tells the debugger the 
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type of device (29f040), the base address (0x0), and the width 
for memory access (16). Next you erase the device and then 
program it by downloading code. 

Once youVe programmed the flash at address 0x0, you need to 
remove that device from the configuration table using the 
RemoveDeviceO command. You need to remove the existing 
device, so you can configure the flash memory that starts at 
address 0x80000000. The command to configure the remaining 
flash chip is amd29f040(Qx800000009 8). This tells the 
debugger the address of the next device, and that the access is 
now 8-bit. 

Using MWX-ICE and the SuperTAP, you can expect to 
program a 512Kflash component in less than five minutes. 
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0x80000000 


Command: 




2 (512Kx 8-bit) 



AMD29f040 

I I 

8-bit width (CS1) 
amd29f040(0x80000000,8) 


AMD29f040 AMD29f040 

(# 1 ) (# 2 ) 


16-bit width (CSO) 
Command: amd29f040(0x0,16) 


Figure 4-1 Example showing commands to configure flash memory devices 
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How to program your flash memory 

Programming flash memory is easy using MWX-ICE macros 
and commands. Once you run the macros, you can program 
flash using the MWX-ICE load and dnl commands. 


Basic procedure 

Using MWX-ICE and the SuperTAP to program the flash 
memory components in your target is relatively straight 
forward. The basic procedure includes the following steps: 

□ Including the flash programming macros. 

□ Configuring the device. 

a Erasing the contents of the component. 

□ Programming the device by downloading code. 

□ Locking the device to prevent accidental writes. 

These steps are described on the following pages. 
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Figure 4-2 Flow chart showing MWX-ICE flash progiamtning procedure 


Including the flash programming macros 

Before you can program, erase, or lock the flash memory in 
your target, you need to set up the programming macros. These 
macros are in a file called Flash.inc. To set up the macros, you 
must direct MWX-ICE to process the file containing the 
macros. You need to have this file included whenever you wish 
to program flash, so you may want to include as part of your 
startup configuration. 
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The macros are in a file called Flash.inc, which is located in the 
in$talldir\amc\st8xK directory. 

> To setup the flash memory macros: 

1. Start MWX-ICE. 

2. From the File menu, choose Include Commands. 

3. In the Windows file browser, chck the amc directory, and 
then chck the stSxx directory. 

4. Select Flash.inc and chck OK 

The Command window displays the macros as they are read. 
It may take awhile for the file to be processed. When the in¬ 
clude file is finished, the Command window stops scrolling. 

For information about including command files at startup, 
chck Help from the Startup Options Editor. 
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Configuring flash memory components 

The first time you program flash using MWX-ICE, you need to 
configure the device specifications. MWX-ICE needs to know 
the type of device, the base address, configuration, and virtual 
width of the flash memory device. Note that you can only 
configure and program one device at a time. If you have already 
configured a flash memory component, you need to unlock it so 
you can program it again, or you need to remove it, if you want 
to program a different device. 

> To configure the flash device 

1. Be sure to include the flash programming macros. See 
page 4-6. 

2. Specify the base address, configuration, and virtual width of 
the flash memory device, using the AMD or Intel macro 
provided for your device. 

For the fist of supported components and their configuration 
commands see page 4-12. 

For example, for an Am29F040 with a base address of 0x0 
and a width of 16, enter: 

Amd29f040(0x0,16) 

For some components, such as the Intel 28F200, which can 
be configured as either an 128Kx 16, or 256Kx 8 device, you 
enter the base address, and the input/output architecture (8 
or 16), as well as the width for memory access. 

Intel28f200(0x0, 16, 16) 

3. Once youVe configured the device, you need to erase the 
contents: 

EraseDevice() 
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Note 



Once write protection to the flash device has been disabled (by 
using the Amdcfei’ice, Intelcfeuice, orUnlockDeviceO macros, all 
writes in the device address range are programmed. To avoid 
inadvertently writing to your flash devices, be sure to disable 
flash programming by using the LockDeviceO macro once 
programming is complete. 


Downloading code to flash memory 

You program the flash by downloading code to target. It may 
take several minutes to download the code to flash. Once the 
device has been configured, all writes in the address range of 
the device go to the flash component. For this reason, you need 
to lock the device when you are finished programming. 

>- To program the flash device 

1. Program memory using the load or dnl commands. 

For example, to load the Intel hex file, myfile, enter: 

dnlfmt Intel 
c3nl “myfile" 

Note: You may need to change to your working directory. 

2. Once you’ve programmed the flash, you need to disable the 
flash-programming feature so that flash memory is not 
inadvertently programmed: 

LockDevice() 


Programming flash that has already been configured 

If you want to program flash that has already been configured, 
and you are programming the same device with the same base 
address and width, you don^t have to configure it again. You 
just need to unlock it and clear the memory contents. 
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If you have already included the flash support file and are 
programming the same device with the same base address and 
width 

> To open the device for programming 

1. Enable flash programming: 

UnlockDevice() 

2. Erase the device: 

EraseDevice{) 

3. Program memory using the load or dnl commands. 

For example, to load the Intel hex file, myfile, enter: 

dnlfmt Intel 
dnl "myfile" 

Note: You may need to change to your working directory. 

4. Once you’ve programmed the flash, you need to disable the 
flash-programming feature so that flash memory is not 
inadvertently programmed: 

LockDeviceO 
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Programming another flash component 

If you have already included the flash support file and are 
programming a different device or the same device type with a 
different base address or width, you first need to remove the 
existing configuration. 

>• To remove a device 

■ Use the following command. 

RemoveDevice () 


Once youVe removed the existing device specification, you can 
configure another one, see 

□ “Configuring flash memory components” on page 4-8. 

□ “Downloading code to flash memorjr” on page 4-9. 


Flash memory support 


The following flash memory devices can be programmed using 
SupeiTAP and MWX-ICE. The following tables show the name 
of the component, and the syntax of the command used to 
specify the flash memory configuration. 
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AMD flash memory components 


Component 

Configuration command 

29f010 

Anid29f010(6ase_c(i(ires5, width) 

29fD16 

Amd2Qf01QQ}ase_address, width) 

29f040 

Amd3QS)A0(Jbase_address, width) 

29f080 

Amd29f080(6cse_acidress, width) 

29fl00 

Aind29fl00(6cse_cdc?ress, hySorlB, width) 

29f200 

Amd29f200(6asg_a<idr€ss, by8orl6, width) 

29f400 

Aind29f400(6asc_£Kiciress, by8orl6, width) 

29f800 

Amd29f800(6asc_cc?<iress, bySorlS, width) 


Intel flash memory components 


Component 

Configuration command 

28f001 

Intel28fD01(6asc_cKi(ircss, width) 

28f002 

Intel28f002(6csc_CKidress, width) 

28f004 

Intel28f004(6ase_CKi(iress, width) 

28f008SA 

Intel28fD08SA(6asc_a<idress, width) 

28f400 

Intel28f400(6as«_(Midress, bySorlS, width) 

28f200 

Intel28f200(6cse_ad(iress, by8orl6, width) 

28fD16SA 

Intel28f016SA(6ase_cddress, bySorlS, width) 

28f032SA 

Intel28f032SA(6asc_ccWress, bySorlS, width) 
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Configuration command syntax 


Argument 

Description 

basejiddress 

The address where the flash 


component is located. The address 
must be expressed in hexadecimal. 

by8orl6 

Used for those components that 
provide user selectable 8- or 16-bit 
operation. 

Use: For: 

8 x8 devices. 

16 xl6 devices. 

width 

The width of the memory access. 

For example, four x8 devices can 
be linked in parallel to create a 
region of 32-bit memory. This 
region could then be accessed by a 
chip-select using a 32-bit port. 

Use: For: 


8 8-bit width. 

16 16-bit width. 

32 32-bit width. 
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Rash memory macros 

The macros for programming flash memory are Hsted in the 
following table. The macros are also described in Help. Just 
like MWX-ICE commands, you invoke the macros in the 
Command window. Note, however, that macros behave a little 
differently from MWX-ICE commands: 

□ Macros are case-sensitive. 

□ You must type the opening and closing parentheses () even 
if the macro takes no arguments. 

□ The Flash programming macros are only available if you’ve 
included the Flash.inc file. 


Macro 

Description 

Amddeviceibasejxddr, width) 

Amdideviceibasejiddr, bySorlS, width) 

Specifies the base address and width of flash 
“memory to be programmed. 

lateldevice{basejxddr^ width) 

InteMeviceibasejxddr, by8orl6, width) 

Specifies the base address, configuration, and 
“width of flash memory to be programmed. 

EraseDeviceO 

Erases the device specified by P^raAdevice or 
IntAdevice. 

LockDeviceO 

Disables flash programming. 

RemoveDeviceO 

Removes existing flash device specification, 
allowing new devices to be specified. 

UnlockDeviceO 

Enables flash programming. 


Macro names 

If you want to rename the macros, edit the Flash.inc file, after 
first making a backup copy. 

Note: The emulator variables in the Flash.inc file are intended 
to be used only by the macros. 
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Chapters 

Tracing Program Execution _ 

Using the trace features of MWX-ICE, you can capture and 
record, in real time, the execution history of the processor as 
SuperTAP executes the target program. Using trace history, 
you can verify the correct performance of the software and 
hardware, and find errors that may occur in the program's 
execution. 


Note 



Contents 

Page 

What is trace? 

5-2 

How you can use trace 

5-3 

Preparing to capture trace 

5-4 

Using the Emulator Trace window 

5-14 

Using liie Command window trace display 

5-21 

Notes on using trace 

5-30 

All of the commands mentioned in this chapter are fully 
explained in the command reference provided in Help. 
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What is trace? 


The SuperTAP emulator uses a sophisticated system to record 
the bus activity and execution history of the target appHcation 
in realtime. This information is stored in the emulator's trace 
buffer. Trace accumulates on every clock cycle and is pipelined 
to qualify cycles for retention and to synchronize timing with 
the emulator's event system. 

The emulator's trace buffer can store approximately 32,000 
frames of trace. A trace frame is like a frame from a motion 
picture film: the frame shows the state of the processor activity 
at each clock cycle. When you view the trace frames together, 
you get a complete history of program execution. 

Each trace frame contains 128 bits of information. Using 
emulator trace capture variables and the event system, you can 
selectively filter the kinds of processor activity you wish to 
capture. Once trace has been captured, you can use trace 
display variables to view the contents of the trace buffer in 
several different ways. You can view trace in either the 
Emulator Trace window or in the Command window. 
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How you can use trace 

The tutorial in Chapter 10 includes several expanded examples 
of trace capture and display. You may wish to work through 
one or all of them to familiarize yourself with the features at 
your disposal. The following section describes some of the more 
typical uses of the emulator’s trace features. 

Qualify trace using the event system 

Trace can be captured so that only the activity of interest is 
retained. This qualified trace capture maximizes the available 
trace buffer and saves you time. 

Execute and trace power-up or reset sequences 

You can a execute a target power-up or reset sequence while 
collecting trace history. With this you can more easily debug 
startup code. 

View trace white running 

The SupeiTAP emulator allows you to view and upload trace 
history without stopping or even pausing emulation. This 
means you can view your program's activity without disturbing 
its real-time operation. 

Analyze timing 

Timestamp information provides a quick, accurate way to 
measure time spent during specified portions of target 
execution. 

Save trace history for anaiysis 

You can easily store trace history in a file. You can specify a 
journal or log file in an MWX-ICE notebook, then simply 
display trace. You can even log trace to a file without stopping 
emulation. After trace is saved, you can edit the file to add 
comments for future reference. For example, comments may be 
added to aid in documenting failure conditions. 

You can use either the log or journal commands or the guided 
configuration provided by the Debugger Files Notebook. 
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View trace while running 

SuperTAP allows you to view and upload trace history without 
stopping or even pausing emulation. This means you can view 
your program's activity without disturbing its real-time 
operation. 


Preparing to capture trace 

When enabled, the trace system uses the captured raw bus or 
clock cycles as the basis for trace display. Several configuration 
variables are provided to specify when to enable and disable 
trace and which cycles to collect in the trace buffer. 

The following sections provide standard switch settings for 
each of the most common t3^es of trace capture. Settings are 
expressed in a manner suitable for use as command files. A 
command file is simply a file containing debugger commands 
that will be executed when the file is loaded using the 
debugger's include command. Such files can be very useful in 
eliminating frequently dupHcated keystrokes and actions. 

The settings shown are by no means the only possible 
combinations. In many cases, these basic settings can be 
combined; for example, those for trace disassembly and 
continuous tracing during run. 

Each switch is a separate command. See the Help for a 
complete description of each command syntax, options, and 
limitations. 
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starting with an empty trace buffer 

The contents of the trace buffer are retained between sessions 
unless the emulator is powered down or reset. In a multi-user 
environment or when starting a new debugging session, always 
clear the trace buffer before beginning to capture new trace. In 
addition, a change to trqual (see below) alters the trace 
capture criteria. Anytime you change trqual, you should clear 
trace before proceeding. 

> To clear the trace 

■ Switch to the Command window. In the Enter Command 
box, type trclr and click Enter Command. 

—or— 

Switch to the Emulator Trace window. From the Actions 
menu, choose Clear Trace. 


Setting the trace capture variables 


Keywords: 

TRSYS 

TRACE 

TRQUAL 

SIGA^MUX 

SIGB^MUX 

TIMCLK 

TRINIT 

TRRUNCLR 

TRCEXT 

PPT 


Ten trace variables govern whether and how trace is captured. 
They must be set before you begin.You can set these variables 
in the Trace configuration dialog box or from the Command 
window. 

To open the Trace dialog box 

1. From the Displays window, choose Emulator Configuration. 

2. In the Emulator Configuration window, click Trace. 


Because the SuperTAP multiplexes some signals to the event 
and trace systems, you need to select which of these signals to 
record in trace. You can open the Event configuration dialog 
box, or use the siga_mux and sigb^mux commands to select 
the signals. 
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Trace Capture Options 
Set these before running 
code. 


Trace Display Options 
These options control 
the display of trace in 
the Emulator Trace 
Window and in the 
Command window. 

Trace Display Options 
These options control 
the display of trace in 
tfie Command window 
only. 



Figure 5-1 The Trace dialog box. 


> To set trace options 

■ In the Trace dialog box, select the settings for each option, 
then click the Apply button. 

You can leave the Trace dialog box open while you create 
your event system statements. 

—or— 

■ From the Command window, t 5 rpe the name of the command 
and press return. 

The following tables lists the trace capture commands. 
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Command Description 


trsys 

Enables the trace subsystem. It should be on 
at all times. 

trace 

Enables trace capture. It should be on imless 
you are using the event s 3 rstem’s trace control 
actions to qualify trace. 

trinit 

Selects the initial state of trace capture at 
run. It should be on unless you are using the 
event system’s trace control actions to qualify 
trace. 

trrunclr 

Clears (on) or appends (ofiO trace to the 
current trace buffer at each run. 

trqual 

Determines whether bus or clock cycles—or 
only enough cycles for disassembly—^are 
captured. For disassembly, trqual must be 
set to dxqual. 

You should always clear the trace buffer after 
changing the trqual value. 

siga_miix 

Selects which multiplexed signals to record 
in trace (irq[0,1, 7] or lsa[0,1, 7]). 

sigb_miix 

Selects which multiplexed signals to record 
in trace (irq[2:6], lsa[2:6], wp, pcmcia, dp, 
rsv). 

trcext 

Enables capture of external bus cycles. 

ppt 

Enables capture of peeks and pokes during 
pause. Typically left off. Peek/poke cycles are 
not shown in disassembled trace. 

timclk 

Selects timestamp clock resolution (40ns, 
200ns, lus, lOus, lOOus, 1ms, 10ms, or 
100ms). 


SuperTAP 8XX 


5-7 




Keywords: 
Raw trace 


See "Capturing trace suitable for disassembly’' on page 5-10 for 
additional variables that must be set for trace disassembly. 
Each of these variables is described in detail in Help. 

Capturing continuous raw trace during run 

The most common configuration for trace capture is to capture 
enough cycles for trace disassembly at all times during run. 
This way, you can look at raw trace as well as disasssembled 
trace. As die trace buffer becomes full, newly captured trace 
frames overwrite the oldest frames. At each pause to run 
transition, new trace is appended to the trace buffer. 


Set 

trsys on 
trace on 
trinit on 
trqual dxqual 
trrunclr off 


To do this... 

Turn trace system on. 

Turn trace capture on. 

Select initial trace state at nm. 
Capture enough cycles for disassembly. 
Append to buffer at return to run. 


You may want to toggle trqual to clock to capture a frame of 
trace for each processor clock cycle. 


Keywords: 
Trace clearing 


Clearing raw trace at each return to run 

If you want to capture raw trace and start fresh at each return 
to run mode, use the trrunclr switch. You can also clear trace 
manually during drun or pause mode using trclr. 


Set_ 

trsys on 
trace on 
trinit on 
trqual dxqual 
trrunclr on 


To do this... 

Turn trace system on. 

Turn trace capture on. 

Select initial trace state at run. 
Capture enough cycles for disassembly. 
Clear buffer at return to run. 
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Keywords; 
Trace control 


Stopping trace when the trace buffer is full 

If you want to prevent overwriting trace, configure the switches 
to turn off trace when the buffer is full. This setup requires that 
you save or clear trace at each pause, and restore the trace 
switch to its on setting. 


Set 

trsys on 

trace on 

trinit current 

trqual dxqual 

trrunclr off 

when trfull then 
troff 


To do this... 

Turn trace system on. 

Turn trace capture on. 

Use previous state at return to run. 
Capture enough cycles for disassembly. 
Clear buffer at return to run. 

Turn off trace when buffer is full. 


Options include adding a break action to troff so that 
emulation stops when the buffer is full. If you know that you 
will preserve any needed trace at each pause, you might change 
trinit and trrunclr to on. This empties the trace bxiffer and 
turns on trace each time the emulator returns to nm. 


Keywords: 
Tracing peeks/ 
pokes 


Capturing peek/poke activity 

Peeks and pokes are reads and writes that you or the emulator 
performs in memory during pause or emulation. 


Set 

trsys on 
trace on 
trinit on 
trqual bus 


trrunclr off 
ppt on 


To do this... 

Turn trace sjrstem on. 

Turn trace capture on. 

Select initial trace state at nm. 

Capture bus cycles.When you use 
dxqual, only non-peek/poke trace will 
is disassembled. 

Clear buffer at return to run. 

Include peek/poke activity. 
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Keywords: 

Trace 

qualification 


Keywords: 

Disassembly 

setup 


Qualifying trace using the event syst^ 

Certainly the most efficient use of trace is to qualify it using the 
event system. This ensures that only the activity associated 
with specified events is preserved. 


Set 

trsys on 
trace off 
trinit current 
trqual bus 

trrunclr off 

when add==addr 
then tron 

when add==addr 
then troff 


To do this... 

Turn trace system on. 

Turn trace capture off. 

Select initial trace state at run. 

Capture bus cycles. Use dxqual if 
trace will be disassembled. 

Clear buffer at return to run. 

Turn on trace with selected event. 

Turn off trace with selected event. 


vfaen event Capture single <grcle of interest, 

then trone 


If you plan to disassemble trace qualified by tiie event system, 
use the settings shown below for disassembly. Combine the 
trace control event statements with the trace system control 
settings. 

Capturing trace suitable for disassembly 

To disassemble the raw trace cycles, the trace system requires 
a certain continuity of execution flow. Without it, the 
disassembler cannot reconstruct program execution. 
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To be able to disassemble trace, you must ensure that the 
processor show cycles are enabled so that disassembler can 
follow indirect branch instructions In addition, trqual must be 
set to dxqual to ensure that the cycles needed for disassembly 
are captured. 


Set To do this... 

showinst indirect Enable show cycles for indirect change 
of flow. 


trsys on 
trace on 
trinit current 


Turn trace system on. 

Turn trace capture on. 

Select initial trace state at nm. 


trqual dxqual 
trrunclr off 


Capture enough cycles to allow 
disassembly. 

Clear buffer at return to run. 


dxlabels on Show symbols for branch destinations 

(only effective if MMU performs 1:1 
logical-to-physical translation, or if the 
MMU is disabled). 
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Choosing the trace display interface 

You can use one or both of the system’s trace interfaces: 

□ The Emulator Trace window is designed for interactive, 
point-and-click use of the information in the trace buffer. 

□ Trace can also be displayed in the Command window. 
Command window display enables you to combine trace 
display with command-line controls, macro routines, and the 
system’s log and journal utihties. 

Both interfaces are described in the following sections. 
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Executable Code Source Code 
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Figure 5-2 The emulator's dual-interface trace system 
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Using the Emulator Trace window 

Use the Emulator Trace window as your primary interface to 
the trace system. With simple mouse cUcks, you can 

□ Scroll through the trace buffer. 

□ Change the trace display configuration. 

□ Change the timestamp format and offset base frame. 

□ Set breakpoints using trace information. 

□ Set the current scope based on the trace frame. 

□ Search for any string pattern in trace. 

□ Clear trace. 

> To open the Emulator Trace window 

■ From the Displays menu, choose Emulator Trace. 

The Emulator Trace window opens and displays the most re¬ 
cent screen of trace. 

The Emulator Trace window displays a continuous buffer that 
is updated each time the emulator enters pause or when you 
perform actions that affect trace. To navigate trace, you can 
scroll the buffer or use the controls described in the next 
sections. 


Note 



When the Emulator Trace window’s display option is set only 
to Raw, the window may take some time to refiresh. The trace 
system is scanning backwards through the entire trace buffer 
and discarding invalid cycles. You can interrupt this processing 
by chcking the Stop button. If the trace buffer contents are 
complex, use the Command window for a faster trace display. 
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Rgure 5-3 Emulator Trace window showing mixed with raw and assembly trace 
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Configuring the trace display 

You can configure the trace display using the View and Actions 
menus and on the settings of several trace display variables. 

View menu commands 

The View menu provides options to control the primary display 
features. You can select the current display format to be any 
combination of raw trace, assembly, or source code. 

Show raw trace This option displays bus or clock cycles and 
provides a header that identifies the address, data, and control 
signals. If assembly or source trace is also selected, the header 
information does not appear. 

Show assembly trace Shows assembly language 
instructions. The raw trace firames are converted to their 
corresponding assembly-level instructions. 

Show source trace Shows C or C++ source code. If it is 
available, the source code matching the raw trace firames is 
shown. 
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Figure 54 View menu display options 
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Note 



When the Emulator Trace window is active (open or 
minimized), its display settings must be compatible with the 
setting of trqual. Insertion of assembly and source information 
is a feature of the trace disassembler and requires that trace 
has been captured with trqual set to dxqual or clock. 
Incompatible settings result in an error message. 


Keywords: 
Raw trace 
Disassembled 
trace 


For detailed information about the components of raw, 
disassembled, or source trace, see the tables beginning on 
page 5-33. 

Display timestamp as Offset If offset mode is enabled, 
timing is offset from the base frame selected with the 
Timestamp Frame button (see page 5-19). When you change 
the timestamp display format, the time display is recomputed. 


Display timestamp as Interval In interval mode, the time 
between trace frames is displayed. When you change the 
timestamp display format, the time display is recomputed. 


You can choose to display timestamp in alternate modes in the 
Emulator Trace and Command windows. 


Show preceding source comments This option, when 
enabled, shows up to 10 lines of source code that precede the 
line that generated the current code being displayed, if these 
lines did not generate any code themselves. With this option 
disabled, only the hne that is indicated in the debugging 
information as generating the code is displayed in source 
interleave mode. 


Whenever this option is changed, the display is cleared and 
redrawn with the new information. 
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Actions menu commands 

Six options provide easy access to operations. 



Figure 5-5 Emulator Trace window Actions menu 


Clear Trace The Clear Trace option clears the emulator's 
trace buffer and updates the display. Note that a trace buffer 
contains two or three trace frames after it has been cleared. 
These trace frames are labeled Beginning of Trace and End of 
Trace. 

Break The Break option attempts to set a breakpoint at the 
currently highlighted frame of trace. The frame must have a 
module name and a line number associated with it in the 
Module and Line status fields. Without a module or line 
number, a breakpoint cannot be set, and an appropriate error 
message is displayed. 

Scope The Scope option makes the currently highlighted 
trace frame the scope, both for symbol accesses and in the Code 
window. The current trace line must have a module associated 
with it with it in the Module status field. If there is a source line 
number as well, this is used. Without a module or line number, 
the scope cannot be determined, and an appropriate error 
message is displayed. 
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Timestamp Frame This option makes the currently 
highlighted trace frame the base frame for offset timestamp 
measurement. It represents time zero, and all timing is 
relative to it. Selecting a new base frame clears the time values 
and displays the new timestamp measurements. 

Search The Search option opens a dialog box that you use to 
perform a string search of tiie trace buffer. 



Rgure5*6 Trace Search dialog 


>• To enter a search pattern 


1. Enter the exact string; the search is case-sensitive. 

2. Select whether to search backward through the buffer 
(older) or forward (newer). 


3. Click Apply. 

To stop a lengthy search, click Stop 



If a matching pattern is found, the frame containing the 
requested pattern is placed in the top line of the trace window. 
If the pattern is not found, a message appears. 


To identify all instances of a pattern in the buffer, use the 
tsrch utility in the Conunand window. 
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Note 



When searching for a data pattern or address, use the b 3 d;e 
order as it would appear in a raw trace display with drtdata 
set to all. 


Keywords: 

DRTDATA 


View Frame The View Frame option opens a dialog box that 
prompts you for a frame number. If the value entered is a 
number, trace will be positioned to the requested frame. If the 
number is greater than the number of frames in trace, trace 
will be positioned to the oldest frame. If the value entered is not 
a number, an error box is displayed, and you are asked to enter 
a new value. 

Trace display variables 

There are three trace variables that provide additional control 
over elements of the trace display. You enter these commands 
in the Command window. For detailed information about these 
display variables, see Help. 


Variable Description 

drtdata Controls whether the DATA column in raw 

trace displays only the bytes that are valid in a 
given transfer (drtdata notall), or all four 
bytes that are on the data bus at the time 

(drtdata all). 

drtfuU Controls whether all signals are displayed in 

raw trace. 

dxlabels Controls whether s 3 mibols are shown for 

branch destinations in disassembled trace. Use 
dxlabels on when you are using the MMU and 
address translation is transparent, or when the 
instruction MMU is not enabled. That is, use 
dxlabels on when the physical (effective) 
address is exactly same as the physical (real) 
address. 
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Emulator Trace status 

When the Emulator Trace window is active, status boxes show 
Idle current trace mode beii^ displayed, as well as other 
information about the trace buffer. 

Module Displays the source module (if any) associated with 
the currently highlighted trace line. 

Line Displays the source line number (if any) associated with 
the currently highhg^ted trace hne. 

Timestamp base frame Shows the frame number that is 
used as the starting point (time zero) when the offset format is 
selected. 


Using the Command window trace dispiay 

Use the Command window as your trace interface when you 
need command-driven control of the trace system. Using 
keyboard commands, macros, or include files, you can 

□ Select the portion of the buffer to display. 

□ Change trace display configuration. 

□ Change timestamp format and offset base frame. 

□ Search for address, data, and status patterns in trace. 

□ Save trace to a file. 

□ Clear trace. 


Note 



See "Preparing to capture trace'' on page 5-4 to set up the trace 
system for capturing trace. 
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Displaying raw trace 


Raw trace always displa 3 re tiie trace frame number, address, 
data, timestamp, and certain signal type identifiers. 

> To display raw trace 

■ Use the drt command: 

Type _ To do this... _ 

drt Display the most recent screen of trace. 

drt nnnn. .mrrunm Print the range of trace firames to the 

command window as a scrolling display 
from oldest to latest. 

drt nnnn Display a screen of trace containing the 

specified firame number. 

The header for each page of trace identifies the address, data, 
and control signals displayed. See Help or “Raw trace display 
description” on p£^e 5-35 for a description of display fields and 
symbols. 

>■ To specify raw trace display fields 

■ Use these commands: 

Type _ To do this... _ 

Control whether all signals are 
displayed in raw trace. 

Display only the valid data b 3 rtes in a 
bus cycle. 

Display all four b 3 des of the data bus. 

Determining the number of trace frames 

To determine the number of firames in the buffer, use the 
trframes command. The most recent frame is firame 0. The 
oldest frame is the value returned by the trfirames command. 


drtfull 

drtdata notall 
drtdata all 
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Raw trace 


Figure 5-7 Raw trace showing all signals (drtfull on /trqual dxqual). 

Displaying all signals in raw trace 

The drtfull command controls whether all the signals are 
displayed in raw trace. If you find the trace display to be too 
cluttered, you can suppress the display of some signals. 

The drtfull command does not determine what is captured. It 
simply selects whether to display all signals that have been 
captured in trace. The trace capture variable trqual controls 
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Keywords: 

Timestamp 


which signals are captured. There are two basic groups of 
signals: the group of signals captured in clock mode, and the 
group of signals captured in dxqual and bus modes. 

Once the trace is captured, you can use the drtfull option to 
switch back and forth between a full display of all signals, or a 
filtered display. 

Limiting the data display 

When fewer than 32 bits of data are accessed in a bus cycle, the 
most useful display is as the processor sees the data on the bus. 
The drtdata softswitch allows you to select whether to show 
only the data bytes active for the current bus cycle (notall) or 
all 32 bits (all), even if some bits were ignored by the processor. 

To determine where a byte occurs so you can mask it in an 
event statement, simply switch from notall to all, and 
re-display the trace. 

>DRTDATA NOTALL 
Frame Address Data 
0472 00100008 4FF9 
0471 OOlOOOOA OFOO 
0470 OOlOOOOC FFFC41F9 

>DRTDATA ALL 
Frame Address Data 
0472 00100008 4FF90F00 
0471 OOlOOOOA 4FF90F00 
0470 OOlOOOOC FFFC41F9 

Excluding non-bus frames from raw trace 

You can restrict raw trace to bus cycles. Use the trqual bus 
command to exclude non-bus cycles during c£^ture. 

Configuring the timestamp display 

You can use the emulator’s timestamp to perform a variety of 
timing measurements automatically during run and to display 
those values in raw trace. There are two timestamp modes: 

□ Interval: times the intervals between cycles. 

□ Offset: sets time relative to a specified frame in trace. 
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To configure the timestamp information, use the following 
commands: 

Set To do this... 

trstairp interval Configure display to show time 
between cycles. 

—or— 

trstairp offset Configure display to show time 

relative to trace frame specified by 
trbase. 

trbase nnnn Trace frame that is time zero. 

For example, to see the intervals between interrupt 5 requests, 
enter the following commands: 

trace off 
trinit off 

when status==irq5 then trone 

Then open the Emulator Trace window and select Interval as 
the Timestamp format. 

Displaying disassembled trace 

Disassembled trace can be displayed as assembly instructions, 
C-source instructions, or source, assembly and raw trace 
interleaved. Several variables control what is displayed, and 
three commands enable navigation within the display. 


Disassembled display is possible only if you have used tiie 
proper setup prior to trace capture. This must include setting 
trqual to dxqual. See “Preparing to capture trace” on page 5-4 
for procedxires. 


Sear^ 


Keywords: 

Disassembled 

trace 


Note 
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>- To display disassembled trace 

■ Use these commands: 

Type _ To do this... _ 

dt number Display most recent screen of trace or 

specified range. 

dtb Display trace going backward (firom 

current frame toward earliest). 

dt f Display trace going forward (from current 

frame toward most recent). 

>■ To select what is displayed 

■ Use these commands: 

Type _ To do this... _ 

trdisp type Display assembly (asm), source (src), or 
both (both). 

dxinsert on Interleave raw trace (optional). 

drtfull Show all signals available (on), or filter 

the display (off). 

Figure 5-8 shows a typical example of disassembled trace that 

includes interleaved raw trace. For an explanation of each raw 

trace field, see ps^e 5-35. 

>- To display symbols for branch destinations 

■ Use this command: 

Type _ To do this... _ 

dxlabels on Display symbols in branch destinations 
(on), or show relative address (off). The 
disassembler looks in the symbol table for 
branch destination (MMU must translate 
1:1, or be disabled). 
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>• To include raw trace cycles 


■ Use this command: 


Type _ 

dxinsert on 


To do this... _ 

Include relevant raw trace cycles in the 
disassembled display. 


Frame number 


Source lines 


Arguments 


» X delay{fine, coarse); 

» ^ while ( coarse— ) ; 

00044 fff023d4: 3bde ffff addi 
44 FFF023D8 399E0001 RCS | 

00043 fff023d8: 399e 0001 addi 
43 FFF023DC 2C0C0000 RCS | 

00042 fff023dc: 2c0c 0000 cmpwi 


r30,r30,0xffffffff 

1 

rl2,r30,0xl 

1 

rl2,0x0 



-13.2US 
-13.2US 
-12.8US 
-12.8us 
-12 .4us 
-12.4US 
-12.2US 

-12.2us 
-11.9US 


Time stamp 


Flow Control 


Figure 5-8 Source and assembly display of disassembled trace interleaved 
with raw trace 
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Searching for patterns in Command window trace 

The tsrch command is a command-line utility for searching 
trace. Unlike the Search facihty in the Emulator Trace 
window, tsrch is capable of locating and indexing multiple 
instances of a pattern in trace. 

You can specify a range of frames for the search or use the 
default to search the entire buffer. Search patterns are entered 
as address, data, or status, or combinations of these elements. 
Output reports the trace frame numbers and shows all frames 
with the matching pattern in raw trace format. Using drt or 
dt frame jiumber^ you can display each frame in the context of 
its execution history. 


tsearchl Keyworels: 
TSRCH 


Trace, searching 


For example, to search the entire buffer for all reads of the data 
value 0xC453 at address 0x789f, enter the following: 

tsrch addr==0x789f && data==0xC453 && status==rd 


Keywords: 

Status 

mnemonics 


The address and data values can be a simple value (QxlOOO) or 
a value with a “care” mask (0xl000&=0xf000). Both can be 
expressed as an equivalency (=) or as an inequality (!=). 

Status comparator values are entered mnemonically using the 
same mnemonics recognized by the event system. Mnemonics 
can be logically ANDed using the vertical bar (|): 
statas=mnemonic | mnemonic. See the Help description of 
tsrch for vahd status nmemonics. 


Saving trace to a file 

Trace displayed in the Command window can be printed to file 
and reviewed. 

The journal and log commands (or the associated Debugger 
Files notebook pages) let you easily store trace history in a file. 
You can even create this file without stopping emulation. After 
trace is saved, you can edit the file to add comments for future 
reference. For example, comments may be added to aid in 
documenting failure conditions. 
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□ Log files are formatted such that the commands issued to the 
debugger can be re-run by loading the file. Data printed to 
the command window, such as trace, are recorded as 
comments. 

□ Journal files present trace in a form that closely 
approximates actual screen display. Joimials record your 
command input, the data printed to the Command window, 
and any error or warning messages. 

You can use either the log or journal commands or the guided 
configuration provided by the Debugger Files notebook. Select 
the “File Loading/Execution” topic in the main contents 
window of Help for procedures. 

Clearing the trace buffer 

>■ To clear the trace buffer 
■ Use the trclr command. 
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Notes on using trace 


This section includes a variety of topics that apply to capturing 
and displa 3 dng trace in the Emulator Trace window, and in the 
Command windows. 

Topic 

Page 

Logical addressing 

5-30 

Trace compression 

5-31 

Some common problems disassembling trace 

5-32 

Disassembled trace display description 

5-33 

Raw trace display description 

5-35 


Logical addressing 

If the tar^^et uses the MMU of the MPC8XX, the disassembler 
can use trace information to display addresses as long as the 
logical (effective) and physical (real) addresses are the same. In 
other words, if address translation is transparent, the address 
and S 3 unbol information shown in trace will be correct. 

If you are using the MMU, and your address translation is 
transparent, you should set an emulator trace variable 
(dxlabels on). The dxlabels variable controls whether symbol 
table lookups are performed. As long as the MMU doesn’t 
change the address, the correct symbols will be shown for 
branch destinations. 

If you use the MMU and the logical and physical addressing is 
identical, keep dxlabels on. 

If you are not using the MMU at all, the default (dxlabels on) 
will still be applied. But if you turn dxlabels of^ and then 
later disable the MMU, you must turn dxlabels on again. 
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Trace compression 


When trqual is set to dxqual, the SuperTAP's trace system 
uses two ways of reducing the number of trace frames produced 
by executing a given segment of code. This allows longer code 
segments to be traced without loss of information. This 
compression of the trace is done by synthesizing a couple of 
artificial signals from the processor's raw signals. 

The VF CNT signal is S 5 mthesized by simply counting the 
number of successive sequential instruction messages received 
on the VF pins, to a maximum of 15 instructions. This number 
is reset whenever any other VF message appears, and every 
time a trace frame is written. 

Additional saving of trace frames is achieved with the IQFLS 
signal. As outlined in Section 18.1.1.1 of the MPC860 User's 
Manual, when instructions are flushed from the processor's 
prefetch queue, the number of flushed instructions is reported 
on the next clock cycle after the fetch report of the instruction 
that caused the flush. To avoid writing two trace frames in this 
case, the trace system combines them into one frame by saving 
the VF output from the first frame as the VF MSG and the 
second as the IQFLS. A comphcation of combining the two 
trace frames occurs when the first frame must be written 
anyway because a valid bus transfer occurred on that clock. In 
this case, the trace system writes both frames, repeating the 
VF MSG on the second frame. For this reason reports of the 
VF=4-7 messages (such as BIT and BDT) are sometimes 
repeated in a second trace frame for a single branch. 

Using these techniques, we only have to save trace frames in 
dxqual mode when a vahd bus cycle (including show cycles) 
occurs, when the sequential instruction coimt reaches 15 and 
rolls over, or when a non-sequential VF report is made. All 
other clock cycles are discarded in this trace mode. 

A consequence of this compression is that many instructions 
may be reported on a single trace frame, with a single 
timestamp. The timestamp corresponds to the time of the final 
clock cycle for this series of instructions. Keep in mind that for 
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all instructions on the MPC8XX processor, the time reported 
shows when the instruction was fetched; the exact time that 
the instruction executed cannot be determined in this 
architecture. 

Some common problems disassembling trace 

The emulator captures the processor activity on each bus cycle. 
From this raw data, the emulator is usually able to reconstruct 
the assembly instructions. However, there are times when the 
disassembler may be imable to reconstruct instructions from 
trace memory. The following sections describe some conditions 
when this could occur. 

Unable to disassemble trace frames 

The following are the most common reasons that the trace 
disassembler is unable to complete disassembly: 

a The trqual variable is set to bus or clock, 
a The trqual variable is changed from an unsupported mode 
(bus, clock) to the supported mode (dxqual) without 
clearing the trace buffer. 

□ Trace was collected while processor show cycles were 
disabled (showinst none). 

a Clock-doublit^ is turned on. Clock-doubling is enabled by 
setting bits EBDF of register SCCR to 01 [see the Motorola 
MPC860 User’s Manual, Section 5.8]. 

□ Visibility functions are disabled (bits DBGC of register 
SIUMCR are not set to 11 [Motorola UM, Section 12.4.1.1]). 

□ The event system setup turned trace on and off before 
acquiring sufficient information for disassembly. No 
instructions can be displayed. This also occurs with peek/ 
poke trace (ppt). However, you can still display raw trace 
(drt). 

□ The application code runs a long loop before breaking, and 
showinst is set to indirect and the instruction cache is 
enabled. In this case the direct branch instruction is cached, 
and the disassembler may not be able to reconstruct 
execution. Setting showinst to flow may correct this 
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problem, by enabling show cycles for all direct and indirect 
branching. In cases like this, there is no performance 
penalty. While there is usually a loss of CPU performance if 
flow is selected, in this case there is no performance 
degradation. 


Disassembled trace display description 

C source code 

When displaying both C source and assembly instructions, C 
source lines begin with » and precede the assembly 
instructions associated with them. 

Assembly instructions 

Assembly instructions are decoded and displayed as follows: 


Column Description 


Frame number An index of the bus cycle in the trace 

buffer. The most recently traced cycle is 
the lowest number. 

Address Address of instruction in memory. 

Object code Numeric representation of assembly 

code. 


Instruction Processor instruction and operand.Where 

possible, on branch and tirap 
instructions, the simpbfied Motorola 
PowerPC mnemonics are used. 


Arguments Instruction arguments. 

Flow Shows non-sequential changes to the IP. 

Control For each change, the old IP is shown as 

ZP > address. 

The new IP is shown asIP< address. 
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Timestamp 


Timestamps only appear for trace frames 
representing a bus cycle. If tibe 
timestamp format is interval (trdisp 
interval), the timestamp information is 
recorded as the interval between 
successive bus cycles. If the timestamp 
format is offset (trdisp oflEset), the 
timsestamp is shown relative to the 
specified trace frame number (trbase). 

If symbol information can’t be found 

If symbol information can’t be foxmd, the cause may be MMU 
translation. If the MMU changes the address during 
translation, only the address will be displayed in trace, and not 
the symbol. For example, the following example shows a 
branch instruction to a relative address. 

b .+084c 

As long a the MMU doesn’t change the address during 
translation, the symbol information should be available and 
will appear in trace. 

You also need to make sure the trace option dxlabels is on. 
This option tells the disassembler to check the symbol table for 
branch destinations. 

Note that if the MMU changes the address during translation 
(that is, if the logical to physical address does not correspond 
1:1), the disassembler may display incorrect S 5 rmbol 
information. In this case, make sure that dxlabels is off. 

Flushed instructions 

Instructions that are fetched, but not executed~or only 
partially executed~are indicated by the FLSH mark. The 
FLSH appears just before the timestamp in the trace 
disassembly. 
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Invalid Instructions 

An instruction followed by two exclamation points (!!) indicates 
that instruction is invalid. An invalid instruction is always 
followed by an interrupt. For example, a PowerPC floating 
point instruction would be invalid because floating point 
instructions are not implemented in the MPC860. 

stfdul! rlO, OxOOOa(rlO) 

A common cause for an invalid instruction is a bug in the 
application code that causes the processor to try to execute code 
in a section of memory where there aretft any instructions. In 
this case, the “instruction’" fetched would not likely contain a 
vahd opcode. 

Questionable instructions 

An instruction followed by two question marks (??) indicates 
that the instruction may or may not have been architecturally 
executed. In other words, it’s status is questionable. 
Questionable instructions only appear shortly before a 
discontinuity in trace. This discontinxiity occurred before the 
disassembler could determine if the instruction was executed 
or not. All the disassembler knows is that it was fetched, but 
it’s status is unknown. 


00021 

00080000: 

3d40 

1234 

addis 

no, 0,0x1234 

00020 

00080004: 

394a 

5678 

addi 

rlO,rlO,0x5678 

00019 

00080008: 

3d60 

acac 

addis?? 

rll,0,Oxffffacac 

00018 

0008000c: 

396b 

f ef e 

addi?? 

rll,rll,Oxfffffefe 

00017 

00080010: 

3d80 

elel 

addis?? 

rl2,0,Oxffffelel 

00016 

00080014: 

398c 

beef 

addi?? 

rl2,rl2,Oxf ff fbeef 

00015 

00080018: 

3de0 

0007 

addis?? 

rl5,0,0x7 


•End of Contiguous Section of Qualified Trace- 


Raw trace display description 

The following table describes the raw trace fields that can be 
captured and displayed. The type of trace captured depends 
upon the setting of the trqual command. The drtfuU 
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command filters the captured trace data for display purposes. 
For information on setting the trqual options and displaying 
the raw trace signals, see Help. 


Column 

FRAME 

ADDRESS 

DATA 

RAV 

XFERSIZE 

STS 

TS 

AS 

TA 

TEA 

BI 

BURST 


BDIP 

BR 

BG 


Description 

The decimal count of the line in the trace buffer. Line 0 
corresponds to the most recently traced cycle. 

The hex value of the address bus. 

The hex value of the data bus. 

R read 

W write 

The transfer size in bits (8, 16, or 32), translated firom the 
TSIZOrl codes. 

S Special transfer start (STS*) asserted. 

T Transfer start (TS*) asserted. 

@ Address strobe (AS*) 

A Transfer acknowledge (TA) asserted. 

E Transfer error acknowledge (TEA) asserted. 

> Burst inhibit (BI*) asserted. 

Burst transaction (BURST*) 

$ Asserted 
I Negated 

< Burst data in progress (BDIP*). 

R Bus request (BR*) asserted. 

G Bus grant (BG*) asserted. 
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Column 


Description 

B Bus busy (BB*) asserted. 


BB 

IRQO, 1, 7 


IRQ2:6 


LSAO, 1,7 


LSA2:6 


DPn 


These signals are multiplexed with LSAO, LSAl, LSA7. See 
the siga_mux command. 

• negated 

n asserted (where n=0,1, 7) 

These s^als are multiplexed with LSA2:6, RSV*/CR/KR, 
WP, PCMCIA_B, DPx. See the sigb_mux command. 

• negated 

n asserted (where n=2, 3,4, 5,6). 

Logic State Analysis Signal (LSAO, 1, 7). These signals are 
multiplexed with IRQO, IRQl, IRQ7. See the siga.mux 
command. Use this option when you have an LSA probe 
connected to your target system. 

+ The LSA signal is a physical "1." 

- The LSA signal is a physical "0." 

Logic State Analysis Signal (LSA2:6). These signals are 
multiplexed with IRQ2:6, RSV*/CR/KR, WP, PCMCIA_B, 
DPx. See the sigb_mux command. Use this option when you 
have an LSA probe connected to your target system. 

+ The LSA signal is a physical "1." 

- The LSA signal is a physical "0." 

Data parity (DP0:3). These signals are multiplexed with 
IRQ2:6, RSV*/CR/KR, WP, PCMCIA.B, LSA2:6. See the 
sigb_mux command. 

+ The DP signal is a physical "1." 

- The DP signal is a physical "0." 
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Column 


IWPn 


LWPn 


CHIP SEL 


WEn 

BS 

GPLA0:3, 5 

UAGA$ 


UBGB4 


RSV 


Description 

Instruction watchpoint signals (IW0:2). 

+ The IW signal is a physical "1.” 

- The IW signal is a physical "0." 

Load/Store watchpoint signals(LW0:l) 

+ The LWP signal is a physical "1." 

- The LWP signal is a physical "O." 

Chip select lines 0:7. 

• negated. 

n £isserted (where n=0:7). 

W Write enable asserted (WEOrS*). 

S B 3 d;e selects asserted (BS_B0:3, BS_A). 

General purpose lines (GPL_A0:3, GPL_A5) 

• negated. 

n asserted (where ra=0:3,5). 

UPWAITA/GPLA4* 

+ This multiplexed signal is a physical "1." 

- Ihe multiplexed signal is a ph 3 reical "0." 
UPWAITB/GPLB4* 

+ This multiplexed signal is a physical "1." 

- The multiplexed signal is a physical "0.” 

Reservation (RSV) This signal is multiplexed with LSA2:6, 
WP, PCMCIA_B, DPx. See the sigb.mux command. 

R asserted. 
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Column 

CR/KR 

BUSY 

D/C 

U/S 

CPM 

PCMCI 

PT/RS 

VFCNT 


Description 

X Either Cancel reservation asserted (CR*), or Kill 
reservation asserted (KR*), which means in either case that 
a reservation has been cancelled. 

V Address bus, data bus, and transfer attributes are valid. 
The SuperTAP synthesizes this signal. 

Only displayed when trqual is set for bus or dxqual, and 
drthill is on. 

D Data. 

C Code. 

U User. 

S Supervisor. 

* The bus is driven by the MPC8XX Communications 
Processor module (CPM) instead of tlie Core. 

P The bus is driven by the MPC8XX PCMCIA adapter 
module. 

Program brace or Reservation depending upon the value of 
the D/C column in trace. 

* Program trace if D/C column is code (C). 

* Reservation if D/C column is data (D). 

The SuperTAP creates this signal which tracks sequential 
instructions only. It is the count of the number of 
consecutive sequential instructions reported on this frame. 
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Tracing Program 
Execution 




Column 


Description 


VFMSG 


IQFI^ 

VFLS 

DCONT 

BREAK 

SftRst 

TIMESTAMP 


Reports the value of the VF pins [0..2] on the current clock 
cycle. 


Message 

SEQ 

BNT 

VSNC 

INT 

BIT 

BDT 

BNTF 


VF Meaning 

0 None 

1 Sequential 

2 Branch not taken 

3 VSYNC signal (disabled in hardware) 

4 Interrupt 

5 Branch indirect taken 

6 Branch direct taken 

7 Branch not taken, flush follows 


The value of the VF pins [0..2] on a clock where no 
instruction fetches occiirred. This is when the preceding VF 
had the value 4-7. IQFLS shows tlie number of instructions 
flushed from the "prefetch" queue. 

The value of the VFLS pins [0..1]. Shows the number of 
instructions flushed from the history buffer on the current 
clock cycle. A value of 3 indicates that the emulator is 
paused (tlie processor is in Debug mode). 

D Discontinuous trace frames. 

B Asynchronous break request. 

Rst SRESET* asserted. 

If the timestamp format is interval (trdi^ interval), the 
timestamp information is recorded as the interval between 
successive bus cycles. If the timestamp format is offset 
(trdisp offset), the timsestamp is shown relative to the 
specified trace frame number (trbase). 
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Why do some of the trace frames appear empty? 

When drtfull is off and trqual is set to either bus or dxqual, 
you may see trace frames that appear to be empty except for 
the trace frame nximber and timestamp. These empty frames 
appear when the bus valid signal is not asserted (BUSY). In 
these frames, the only signals that are vahd are DCONT and 
BREAK, the visibility signals (VF CNT, VF MSG, IQFLS), and 
the timestamp. All of the other signals (including address and 
data) may not show valid values, and their display is 
suppressed. The pins for these signals are not actively driven 
at these times. When drtfull is off, the display of the visibihty 
signals is also suppressed. 

When drtfull is on, you can see that the empty trace frames 
contain valid visibility information (VF CNT, VF MSG, 
IQFLS). 
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Chapters 

Using Basic Breakpoints 


This chapter covers the breakpoint features of MWX-ICE. 
Basic breakpoints are tools for interrupting emulation for 
insight into code execution and target function. Breakpoints 
interrupt emulation after memory accesses or before executing 
an instruction. 


Contents Page 

How can you use breakpoints 6-2 

Breakpoint types 6-3 

Basic breakpoint commands 6-5 

Access breakpoints (ba, br, bw) 6-7 

Instruction breakpoints (bi) 6-12 
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How can you use breakpoints 

Once you have run your program and discovered a problem, the 
next step is typically to decide where to break program 
execution so that you can find the source of the problem. 

You use a breakpoint to examine behavior of the target under 
certain controlled conditions. This is very helpful in isolating 
bugs when troubleshooting hardware and software in the 
target environment. 

Use the event system to monitor compound conditions and 
perform various emulator actions based on those conditions. 
The same emulator resources are used to support both 
breakpoints and the event system. See the section “Working 
within the limits'’ for each breakpoint type for information on 
resources. 
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Breakpoint types 


You can set two types of breakpoints: access breakpoints and 
instruction breakpoints. In ad^tion, you can specify how the 
emulator and on-chip resources are used to implement 
breakpoints. However, in most cases it is best to let the 
SuperTAP manage the breakpoint resources (bptsrpe choose). 


Access breakpoints 

Access breakpoints break on reads or writes to data and 
program locations. You can limit an access breakpoint to break 
exclusively on read or write accesses by using the appUcable 
command (breakread, breakwrite). 

An access breakpoint is set for a single address or an address 
range. You can use up to 10 sickle-address access breakpoints 
or five ranges, or some combination of both types. You can set 
up to 10 access breakpoints when the bptype is set to choose. 
This is the default settii^. 

On-chip access breakpoints There are two on-chip access 
breakpoints available. When you select on-chip breakpoints 
(bptype onchip), the breakpoint occurs immediately after the 
data is accessed. Unlike hardware access breakpoints, on-chip 
access breakpoints only break on data accesses, not on 
instruction accesses. 

Hardware access breakpoints You can set up to eight 
emulator hardware access breakpoints (bptype hw). When 
you select hardware breakpoints, the breakpoint actually 
occurs some cycles after the data is accessed. This is known as 
skid. However, it is easy to locate the exact bus or clock Qrcle 
where the break occtirred when you examine raw trace. The 
trace frame where the breakpoint occurred is marked with a B. 
Note that when you exphcitly select hardware breakpoints 
(bptype bw), instruction breakpoints (bi) and temporary 
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breakpoints (go address), and step commands do not work. 
Again, in most cases it is best to let the SuperTAP manage the 
breakpoint resources (bptype choose). 

Instruction breakpoints 

Instruction breakpoints break just before executing the 
selected instruction. 

When bptype is set to choose or sw, up to 50 instruction 
brealqooints can be set in writable memory. Instruction 
breakpoints work by replacing the actual instruction in 
memory with a illegal instruction opcode. 

When bptype is set to onchip, you can set four instruction 
breakpoints. These on-chip instruction breakpoints can be set 
in ROM or RAM. When bptype is set to choose, the SuperTAP 
automatically uses on-chip breakpoints for instructions in 
ROM. 

When bptype is set to hw, instruction breakpoints and 
temporary breakpoints (go address) do not work. Note that the 
step commands also use temporary breakpoints. 
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Basic breakpoint commands 

Control breakpoints with the following commands. For 
complete command descriptions see Help. 


To 

Use 

Abbreviation 

Set a breakpoint to break before execution of a 
specified instruction or range. 

breakinstruction 

bi 

Select among hardware, software, or on-chip 
instruction breakpoints. 

bpiype 

none 

Set a breakpoint on access to specified address 
or rai^e. 

breakaccess 

ba 

Set a breakpoint on a read at specified address 
or rai^e. 

breakread 

br 

Set a breakpoint on a write at specified address 
or range. 

breakwrite 

bw 

Clear all breakpoints or a breakpoint by 
number. 

clear 

cl 


Setting breakpoints 

See tlie sections “Access breakpoints (ba, br, bw)” on page 6-7 
and “Instruction breakpoints (bi)” on page 6-12 for information 
on using the ba, br, bw, and bi commands. 

You can set breakpoints by entering commands in the 
Command window, or by using the Breakpoint page of the 
Execution Controls Notebook, or by using the BreakI button. 
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Displaying breakpoints 

The debu^er assigns a number to each breakpoint for 
reference and displays them in the Breakpoints window. If the 
breakpoint numbers are not displayed select “Show Break #” 
from the View menu. 


Clearing breakpoints 

Breakpoints may be cleared using the clear (cl) command. You 
can clear an individual breakpoint by giving its number or 
clear all breakpoints by not specifying a number. 

Example Description 

cl 3.. 5 Clears breakpoints numbered 3 throi^h 5. 
cl 4 Clears breakpoint number 4. 
cl Clears all breakpoints. 

Breakpoints can also be cleared with the Clear button: 
double-chck the breakpoint and choose the Clear button. 

Attaching macros to basic breakpoints 

The breakaccess, breakread, breakwrite, and 
breakinstruction commands can all be set to invoke a macro 
when program execution is broken. For example, to invoke 
myjnacro after a breakread at line #20, enter 

br #20 ; my-J^acro () 
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Access breakpoints (ba, br, bw) 

Access breakpoints break on reads or writes to data and 
program locations. You can limit an access breakpoint to break 
exclusively on read or write accesses by using the applicable 
command. 

You can use up to 10 single-address access breakpoints or five 
ranges, or some combination of both types. You can set up to 10 
access breakpoints when the bptj^pe is set to choose. This is 
the default setting. 


Setting an access breakpoint 


> To select memory access attributes 

■ Set the address command for the addressing mode 
appropriate for your target. For example, 
address access physical 


For settings, see Help for Hie address command. 

> To enter breakpoint commands 

■ For access breakpoints use the followii^ syntax: 

{ba I br | bw) address \ address_ranffe [ ;macro_iiaine () ] 

Determine which type of access breakpoint you need, the 
address you want to break on, and the name of any macro you 
want to invoke when program execution is broken. 

Enter the breakpoint command on the command line. For 
example. 


br 20h..30h ; foo() 


Keywords: 
Breakpoints window 


Breakpoints can also be set using the Breakpoint page of the 
Execution Controls Notebook. 
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Address values 

Single addresses and address range expressions can contain 
actual memory locations, symbols, constants, line numbers, 
and operators. You can specify an address range by separating 
two addresses with two periods (iDLddressl,.address2\ A b 3 d;e 
offset can also be specified for a range using +n. For more 
information on expressions and S 3 nnbolic referencing, see Help. 


Memory qualifiers 

The settings for the address command affect how addresses 
are quaUfied for access breakpoints. The settings for these 
commands for the access memory type determine Ihe 
addressing mode for a breakpoint address. Note that when 
bptype is set for onchip, the ba, br, and bw commands 
always use logical addressing. 

For syntax, see the “Memory and File Handling^ command 
groupings in Chapter 9; for detailed information, see Help for 
the address command. 


Examples 


Example 


Description 


BR 0x300 


Sets a read access breakpoint at 
address 300 (hexadecimal). 


BW @CDEMON\ \ led_port Sets a write access breakpoint at 

the address of the array 
led_port in the root named 
@CDEMON. 


BA flags. . f lags+10 Sets read/write access 

breakpoint starting at the 
address of the array flags and 
ending 10 bytes after the address 
of flags. 
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Example 


Description 


BR 20h..30h;FOO() 


BR &flags[0] 


BA &count; 
when(k<30) 


BA prime 


Sets read access breakpoints 
from address 20h (hexadecimal) 
to 30h and executes the macro 
FOO on every breakpoint 
between these addresses. 

Sets a read access breakpoint at 
the address of array element 
flags[0]. 

Sets a read/write access 
breakpoint at the address of 
coimt and only stops when the 
macro evaluates k to be less than 
30. 

Sets a readAvrite access 
breakpoint at the address 
referred to by the value in 
variable prime. 

This command is correct if prime 
is a pointer. The breakpoint is set 
at the value of the variable 
prime. For example, if the value 
of prime is 0x0123, a breakpoint 
is set at the address 0x0123. 

This command may not be 
correct if prime is a scalar, since 
the value in prime is treated as 
an address and the breakpoint is 
set at that address rather than at 
the address of the variable 
prime. 
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Example 


Description 


BW &pr ime Sets a write access breakpoint at 

the address of the variable prime 
regardless of its type. 

This command is correct if prime 
is a scalar; it sets a breakpoint at 
the address of the variable 
prime. 

If prime is a pointer, the 
breakpoint is set at the address 
of the pointer rather than at the 
address it is pointing to (i.e., 
prime). 


What happens when an access break occurs 

An access breakpoint stops execution after the access occurs. 
Depending upon the type of access (instruction or data), the 
breakpoint will occur either immediately after the access, or 
some cycles past it. This discrepancy is a function of how the 
breakpoint is implemented. When bptype is set to choose, the 
emulator allocates the breakpoint resources (on-chip and in 
emulator hardware). In some cases, there may be a skid. 

□ When bpt5rpe is set for onchip, execution stops 
immediately following the access, so there is no skid. The 
SuperTAP automatically uses this type of breakpoint when 
the access is for data. 

□ When bptype is set for hw, the breakpoint skids. But you 
can still look in raw trace to locate the exact access that 
caused the break. This is the first trace frame where the 
break bit (B) is set. The SuperTAP automatically uses this 
type when the access is on an instruction, or when on-chip 
resources are depleted. 


6-10 


MWX-ICE User^s Manual (Windows) 



MWX-ICE performs the following functions when it encounters 
an access breakpoint: 

1. Completes execution of the instruction at that location. 

2. Suspends program execution. 

3. Executes a macro (if one was specified when the breakpoint 
was set). Depending on the macro, the debugger will do one 
of the following: 

If the macro return value is true (nonzero), the debugger re¬ 
sumes execution at the instruction immediately after the 
breakpoint. 

If the macro return value is false (zero), the debugger re¬ 
turns to command mode and displays breakpoint informa¬ 
tion. 

4. If a macro was not specified, MWX-ICE returns to command 
mode and displays updated breakpoint information. 

Working within the limits 

Access breakpoints consume S 3 rstem resources. In general, the 
emulator manages these resources and warns you when it 
makes adjustments and presents an error when resources are 
exhausted or when you attempt something that creates a 
conflict. So you need not concern yourself with more than the 
following general guidelines. 

□ Up to 10 access breakpoints are possible (8 hardware, 2 
on-chip). You can have ten single-address breakpoints or five 
ranges, or some combination of both types. 

□ Use of access breakpoints reduces the resources available for 
the event system. 

□ On-chip access breakpoints only work for data accesses. 

Q Hardware access breakpoints have significant skid. 

On-chip caches 

When the processor on-chip instruction and data caches are 
used, you must make sure that instruction or data show cycles 
enabled, or the instruction/data caches will cause the access 
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breakpoints to be missed when cache hits occur. If copy back 
caching is enabled for the data cache, access breakpoints may 
break in sections of code having nothing to do with the access; 
it is just where the processor decided to copy back the cadied 
data to memory. In MWX-ICE, you can use the showinst 
command to enable instruction show cycles (showinst 
indirect). The data show cycles are enabled by setting the 
DSHW bit in the processor’s SIUMCR register. 


Instruction breakpoints (bi) 

When you want to stop program execution on a particular 
instruction in your code, you use an instruction breakpoint (bi). 
With instruction breakpoints, the break initiates and 
completes before the instruction at the specified address is 
executed. 

Up to 50 instruction breakpoints can be set (4 on-chip, and 46 
software instruction breakpoints). They can be set from the 
command line or a one-time temporary breakpoint can be 
attached to the current MWX-ICE go instruction. The step 
commands also use temporary breakpoints. 

Setting an instruction breakpoint 

Some setup is necessary before initial use of instruction 
breakpoints and temporary breakpoints. 

> To perform initial setup 

1. Set the address command for the addressing mode 
appropriate for your tai^et. For example, 

address exec physical 

For valid settii^s see the Help for the address command. 

2. Make sure that bptype is set to choose or onchip. 
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If your code resides in ROM You can set up to four access 
breakpoints in ROM. If you have already used up the four 
on-chip breakpoints, you must map the ROM to emulator 
overlay memory. See “Cop 3 dng memory contents between 
target and overlay’’ on page 3-16. In emulator overlay ROM, 
the area remains protected from target writes during program 
execution, but can be modified by MWX-ICE for breakpoint 
operations. 

> To enter breakpoint commands 

■ For instruction breakpoints, use the following syntax: 
bi address | address__range [ ;inacro_name () ] 

Determine the address you want to break on. Enter the 
breakpoint command on the command line. For example, 

bi step ;when (i=3) 

You can also set instruction breakpoints from the Breakpoint 
page of the Execution Controls Notebook, with the BreakI 
button, and by using the mouse shortcuts in the Code window. 

Address values 

Single addresses and address range expressions can contain 
actual memory locations, symbols, constants, line numbers, 
and operators. You can specify an address range by separating 
two addresses with two periods (addre$$l.,addre$s2). A byte 
offset can also be specified for a range using +n. For more 
information on expressions and symbohc referencing, see Help. 

□ Ensure the address falls on an instruction boundary. 

□ Ensure the instruction resides in writable memory. 

□ Ensure that bptype is set to choose. 
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Setting temporary breakpoints 

A temporary or one-time breakpoint is an instruction 
breakpoint attached to the current MWX-ICE go instruction. 
Temporary breakpoints are commonly used to skip over a 
section of code or a subroutine. 

>- To set one-time breakpoints 

1. Perform <he initial setup as described on pj^e 6-12. 

2. Determine a valid address you want to break on and the 
name of any macro you want to invoke when program 
execution is broken. Enter the go command. For example, 

go 0x1234 

Temporary breakpoints can also be set with the Go Until 
button or with options on the Go To notebook page. 

Memory qualifiers 

The settings for the address command affects how addresses 
are quahfied for access breakpoints. The settings for these 
commands for the exec memory type determine the addressing 
mode used for a breakpoint address. 

For syntax, see the “Memory and File Handling” command 
groupings in Chapter 9; for detailed information, see Help for 
address. 

Exampies 


Example Description 

BI #2 0 Sets a breakpoint at line number 

20. Source-level mode only. 

BI 0x2210 . . 0x2216 Sets breakpoints starting at 

address 2210 and ending at 
address 2216 (hexadecimal), 
assembly-level mode only. 
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Example 


Description 


BREAKI #1..#4 Sets breakpoints starting at line 

number 1 and ending at line 
number 4. May require module 
name. 


BI SIEVE\#28 Sets a breakpoint at line number 

28 in the module SIEVE. 

BI #15.. #18 ; FOO {) Sets breakpoints starting at line 

number 15 and ending at line 
number 18. Executes macro FOO 
after each line. 


BI #10;when(i==3) Sets a breakpoint at line number 

10 and stops only if variable i is 
equal to 3. 

BI 0x93 Sets a breakpoint at address 93 

(hexadecimal), assembly-level 
mode only. 


BI step 


Sets a breakpoint at the address of 
step. 
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What happens when a software instruction break occurs 

When a software instruction breakpoint is set, the specified 
target instruction is replaced with an illegal instruction; 
therefore, they can be set only in writable memory. 

MWX-ICE performs the following functions when it encounters 
an instruction breakpoint: 

1. Suspends program execution before the instruction at the 
breakpoint address is executed. 

2. Replaces the illegal instruction with the original instruction 
at the breakpoint address. 

3. Executes a macro (if one was specified when the breakpoint 
was set). Depending on the macro, the debugger will do one 
of the following: 

If the macro return value is true (nonzero), the debugger re¬ 
sumes execution starting at the instruction where the break 
occurred and displays break information. 

If the macro return value is false (zero), the debugger re¬ 
turns to command mode without executing the instruction 
where the break occurred. 

4. If a macro was not specified, MWX-ICE returns to command 
mode without executing the instruction where the break 
occurred. 

Software breakpoints and trace. 

Trace memory shows the processor fetches and execution firom 
the address a software instruction breakpoint is set to. It is the 
illegal instruction that is fetched and executed, not the 
instruction in your code. Also, the raw trace display may show 
extra fetches that result from filling the CPU pipeline. The 
break has occurred at the specified point, as is shown by the 
instruction pointer. 
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Working within the limits 

Instruction breakpoints consume system resources. In general, 
the emulator manages these resources, warns you when it 
makes adjustments, and presents an error when resources are 
exhausted or when you attempt something that creates a 
conflict. So you need not concern yourself with more than the 
following general guidelines. 

□ The system can manage up to 10 access breakpoints (ba, br, 
bw). System resoxirce are shared with the event system so 
the actual number of breakpoints available may vary. 

□ An instruction breakpoint resource is used for each 
instruction in an address range. 

□ Software breakpoints must occur in writable memory, either 
target RAM or emulator overlay RAM or ROM. 

□ Instruction breakpoint addresses must fall on instruction 
boxmdaries. Misaligned addresses will cause code 
corruption. Use the printsymbols or disassemble 
commands to evaluate instruction addresses. 

□ If you are setting instruction breakpoints or temporary 
breakpoints, the bptype option must be set to choose. 

□ There are four on-chip instruction breakpoints. The on-chip 
breakpoints can be set in target ROM. 
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( Chapter 7 

Using the Event System _ 

This chapter covers the conditional control features of 
MWX-ICE when used with the SuperTAP event system. 

The basic breakpoints feature and the event system can both be 
used to control emulation for insight into code execution and 
target function. Compared to basic breakpoints, the SuperTAP 
event system provides additional flexibility both in what can 
cause the emulator to intervene in code execution and in what 


actions can occur. 
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Feature overview 


The emulator provides a powerful state machine that monitors 
the processor bus and the emulator’s own coimters, groups, and 
states. The system can track deeply nested sets of conditions, 
including recursive and reentrant code sections. These features 
provide powerful debugging capabilities for software debug¬ 
ging and for hardware/software integration. 

□ Up to 32 when/then statements can be defined at any time. 

□ Four event groups and four states provide the logical 
structure necessary for tracking deeply nested bugs. 

□ The event system includes four counters that can be 
monitored and controlled. Two of the counters are the 
processor’s on-chip counters. 

□ Trace collection can be selectively controlled. 

□ Memory and register values can be monitored and modified. 

□ Emulation can be stopped before or after instruction 
execution. 

□ The event system can respond to or produce an external 
trigger signal, which can be used to trigger external devices 
such as logic analyzers or daisy-chained emulators. 
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Event system structure 


The event system provides access and execution break control. 
It allows you to monitor a predefined set of conditions, called 
events, and then perform emulator actions based on those 
conditions by forming Vhen/then” statements. 



The event system monitors emulator functions and target 
information at the bus cycle level, including every read or write 
cycle that the microprocessor executes, until the defined 
condition is encountered. When a defined condition in any 
active when/then statement is encountered, the emulator takes 
the specified action. 


Up to 32 when/then statements are supported. When/then 
statements are active in all four event groups unless tied to a 
specific group when the statement is defined. Commands are 
provided to manage which group and which statements are 
active at any given time. Additional commands are provided to 
manage features used by the event system, such as the 
coimters, and trace capture system. 
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Figure 7-1 Event system structure 
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Event system commands 

The following commands are used to define, control, or display 
event system statements. 


To 

Command 

Abbreviation 

Define when/then 
statement. 

when 

wh 

Disable when/then 
statement. 

whendisable 

whend 

Enable when/then 
statement. 

whenenable 

whene 

Display or save event 
system setup. 

whenlist 

whenl 

Clear when/then statement 
or setup. 

whenclr 

whenc 

Display/specify event group 
active at nm. 

group 


Attach a named macro to a 
when/then break action 
statement. 

breakcomplex 

be 

Set/clear event system 
state flags. 

state 



The commands above are documented in Help. 

Setting event system options 

You can configure event system options using the either the 
Command window or the Event configuration dialog box. These 
options are used to control or display the state of event system 
coimters, display or set the current active group or state, or 
select the multiplexed signals that can be used as inputs to the 
trace and event systems. 
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> To open the Event dialog box 

1. From the Windows menu, choose Emulator Configuration. 

2. In the Emulator Configuration window, click Event. 


' B 

mwx-icest860 - Event 

Event System (EVTSYS); 

[ ErwJjled Oj 

Group: 

ii o I 

Signal group A nux selection: iIRQ C0:l:7] o 1 

Signal group B nux selection: [ IRQ [2-61 D i 

State: 

nnsi 

Counter # 

Value Initial Value 

1: 

lUse Current Value at Run s 1 

2: 

10 i t Use Current Value at Run D 1 

Onchip Counter t 

Value 

10 1 

B: 

L2-1 

—1 

{RppImK ^Restore Value! iCancell iHelpI 


Figure 7-2 The Event dialog box. 

> To set event options 

■ In the Event dialog box, select items firom the option menus 
or enter values, then click the Apply button. 

You can leave the Event dialog box open while you create 
your event system statements. 


■ From the Command window, type the name of the command 
and press return. 
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The following table lists the event system options. 


To 

Command 

Display counter n value. 

ctxn 

Set the initial value of counter n. Only 
applies to the emulator counters (1,2). 

ctrnival 

Display all event state variables. 

evtvars 

Selects which multiplexed signals to use 
as inputs to the event system (irq[0,1, 7] 
or lsa[0,1, 7]). 

siga^mux 

Select which multiplexed signals to use as 
inputs to the event system (irq[2:6], 
lsa[2:6], wp, pcmcia, dp, rsv). 

sigb_mux 

Display/specify event group active at run. 

group 

Set/clear event system state. 

state 


Event system statements 

The basic event system “when/then” statement is of the form: 

when event__expression(s) then action($) 

When the event_expression occurs, the specified actions are 
taken. Event expressions and actions may include several 
logically related events. 
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Setting up when/then statements 

The following sections provide an overview of event and action 
options. See the Help command descriptions for when, when 
events, and then actions for detailed information on when/then 
statement syntax and definition. 


When evenLexpression(s) 

An event expression is a logical combination of one or more 
events. Events can be combined or negated in the event 
expression. The following events can be used in an event 
expression. 


To test when: 

Use: 


An address of the specified value appears on 
the address bus. 

address 


The specified counter value is reached in the 
numbered counter. Only applies to the 
emulator counters (1, 2), 

ctrn 


The specified data value appears on the data 
bus. 

data 


The instruction at the specified address is 
about to be executed. 

execaddr 


The specified group is active. 

groupn 


The data at the memory address is as specified 
and another event condition has been met. 

memory 


The specified value appears in the register and 
another event condition has been met. 

register 


The specified status condition(s) appear on the 
bus. 

status 


The 32K trace buffer is full. 

trfuU 
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To test when: 


Use: 


A TTL trigger input of at least one bus cycle trigin 
duration is received via the BNC trigger input 
connector on the back of the emulator. 

Then action($) 

The emulator performs actions when the defined events are 
encountered while running the target system program. 
Multiple actions may be Usted, separated by commas Q. The 
following actions can be used in the when/then statement. 


When the event condition is true, to: Use: 


Stop program execution either just following break 
an access or just prior to instruction ocbrk 

execution. You can also specify whether you hwbrk 
want to use on-chip, emulator hardware, or swbrk 
software breakpoints. 

Zero, set to a specific value, increment or ctrnrst 
decrement the specified coimter. ctrnset 

Note: You can only set, increment, or reset ctrninc 
the emulator coimters (1, 2). The on-chip ctradec 
counters (A, B) can only be decremented. ctrbdec 

Change to the specified group. groupn 

Zero, set to a specific value, or increment the memrst 
specified memory location. memset 

meminc 

Zero, set to a specific value, or increment the regrst 
specified register. regset 

reginc 

Generate a TTL-level signal on the emulator trigout 
trigger-out BNC connector. 

Call and execute the specified target routine call 
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When the event condition is true, to: 


Use: 


Turn trace capture on or off, or capture a tron/ 
single cycle. troff' 

trone 


Examples of when/then statements 

Below are examples demonstrating event system when/then 
statements. These examples cover commonly used event/action 
combinations. Refer to the two tables above for other events 
and actions. 

□ Break emulation when address 0x100 appears on the bus. 
when address==0xl00 then break 

□ Trace only the write cycles to the memory mapped port, 
led_port[0]. 

when ad==(&led_port[0]) && status==wr then trone 

□ Trace only the write cycles to the memory mapped port, 
led_port[0], when written to by a subroutine (outdot in the 
example). 

when execaddr==outdot then group2 

when execaddr==outdot_end then groupl 

when group2 && ad== (&led_port [0]) && status==wr then 

trone 
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Valid event/action combinations 

Most actions and events can be used alone or in combination. 
The exceptions are shown below: 

Invalid combinations Rules 


when address && execaddr 


when event && execaddr then trone 
when event && memory then trone 
when event && register then trone 


when ctrn && ctrn then ... 


when execaddr && status 
when execaddr && data 

when execaddr==start..end 


when groupn then ... 
when memory then . . . 
when register then .., 


when groupn || groupn 

when status mnemonic && mnemonic 


Do not combine address and execaddr in 
the same statement using the AND (&&) 
operator. You can OR (11) the two events. 

With execaddr, memory, or register 
events, do not use trone, iron, troff, 
groupn, Staten, ctrninc. ctrndec, or 
trigout actions. 

A statement can include only one counter 
event. 

Do not combine the execaddr event with 
status or data events. 

Do not use an address range with the 
execaddr event unless you are using on- 
chip breakpoints (bptype onchip). 

The group, memory, and register events 
must be combined with another event 
using the AND operator (&&). Valid events 
are address/execaddr/data/status/ 
staten/trigin/trfull. 

Multiple group events cannot be combined 
in the same statement. 

Use a vertical bar (|) as the AND operator 
when you combine status mnemonics (do 
not use &&): 

when status mnemonic | mnemonic... 
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Qualifying event system memory accesses 

All address comparisons must specify the transfer size and 
addressing mode appropriate for your target. 

Address-based comparisons or actions can be qualified using 
the address and size commands with the event memory 
access type. 

ADDRESS EVENT mode Determines whether an address is 
interpreted as logical or physical. 

Note that this does not apply to on-chip events, which always 
use logical addresses. On-chip eveiits are statements that use 
ctrxdec or ocbrk actions. 

The execaddr and memory events and memory actions can 
override the address command setting within their syntax. 

To override the address variable setting for the address 
event, use the AND operator (&&) to combine it with the 
event. 

The following table shows which qualifiers must be set for each 
event/action. 

Event/ In when/then In command 

Action statements, use: settings, use: 


address 

execaddr mode: 

memory mode: 

data grain 


address event physical 
address event mode 
address event mode 


where the memory qualifiers have one of these values: 

mode logical_code logical_code 

logical_data logical__data 

physical physical 
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Event/ 

Action 


In when/then in command 
statements, use: settings, use: 


data__grain /I /I 

/2 /2 



Example 


Change the value at logical address (logical_code:) QxffeO to 
FF (byte = /I) after counter 1 is 10: 


when ctrl==10 then memset logical_code Oxffe0=0xff/I 


This could also be done the following way: 

address event logical_code 
size event 1 

when ctrl==10 then memset 0xffe0=0xff 


Using the event system 

Displaying and saving when/then statements 

The current when/then statements can be displayed or saved 
using the whenlist command. To display the statements, use 
whenlist with no argument. A numbered list of statements is 
displayed. 

To save the current when/then statements in a file \ise 
whenlist with the desired filename as an argument. For 
example, to save the current when/then statements to a file 
named my^eventsdnc, enter: 

whenlist iny_events. inc 
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To use the when/then statements you saved with whenlist, 
choose Include Commands from the File menu, and select the 
name of the command file. You could also enter the include 
command in the Command window: 

inc rayevents.inc 

If you want to include a command file each time you start the 
debugger, use the Startup Options Editor. 

Enabling and disabling when/then statements 

When/then statements are automatically enabled when they 
are created. They may be temporarily disabled and re-enabled. 


Enter: 

To: 

whendisable 3 

Disable statement 3. 

whendisable 2..4 

Disable statements 2, 3, and 4. 

whendisable 1,3,4 

Disable statements 1, 3, and 4. 

whendisable all 

Disables all when/then statements. 

whenenable 3 

Enable statement 3. 

whenenable 2..4 

Enable statements 2,3, and 4. 

whenenable 1,3,4 

Enable statements 1,3, and 4. 

whenenable all 

Enables all when/then statements. 

Clearing when/then statements 


When/then statements can be cleared using the whenclr 
command. When an event is cleared, it is removed from MWX- 
ICE. 

Enter: 

To: 

whenclr 3 

Clear statement 3. 

whenclr 2..4 

Clear statements 2,3, and 4. 

whenclr 1,3,4 

Clear statements 1,3, and 4. 

whenclr all 

Clear all statements. 
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Groups 


A group is an exclusive state within the event system defined 
by when groupn events and enabled by then groupn actions. 
When a group is current, only associated when/then 
statements (and any global statements) can cause event 
system actions. 

Changing groups activates the alternate set of events. Use the 
group command during pause to determine which group is 
currently active or to change the active group. At each go, the 
group specified by group becomes the current group. Other 
event groups become current dynamically by switching groups 
as a groupn action of the event system. 

Figure 7-3 illustrates the relationship between statements and 
groups. Statement #6 belongs to all four groups because no 
group was included in the statement definition. 

#1 when address==end_init && groupl then group2 
#2 when group2 &.& address—conveyer2 then groups 
#3 when groups && address==chec7dbelts && data==0x0004 
&=0x4 && status==rd then group4 
#4 when group4 && address==jbeltjam. .+0x400 && 
status==rd then ctrlinc 
#5 when group4 && ctrl==100 then break 
#6 when trigin then break 
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Example 

As an example of the common use of two groups, you may wish 
to trace a subroutine after it has been called by module A or 
module B, but not if it has been called from modules C, D, or E. 
In this case, you would define a set of when/then statements to 
the address ranges of modules A and B. When either of these 
modules is encountered, switch to group2 and look for the 
subroutine. After tracing the subroutine, switch back to 
groupl. 

trsys on 
trace off 
trinit current 

when address==A..+100 || address==B..+80 && groupl 
then group2 

when address==sujbroutine && group2 then tron 

when address! =sujbroutine && group2 then groupl,troff 

General characteristics 

□ Statements are global (active in all groups) xmless tied to a 
specific group in the when clause. Notice in Figure 7-3 that 
statement #6 appears in all groups. 

□ Among the fom groups, no more than 32 when/then 
statements can be defined at one time. 

□ A group event must be paired with another event to be valid: 
when ad==0xl00..Oxlff && group3 then tron 

—not— 

when groups then tron 

□ Once a group change occurs, the system remains in that 
group imtil explicitly changed to a new group, even if the 
condition causing the group change is no longer true. 

a Multiple group events cannot be combined in the same 
statement; for example, 
when groupl || group4 

is invalid. 

a If you change to a group in which states are also defined, but 
do not specify a state as part of the group change action, the 
system defaults to state 1. 
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States 


States can be used globally or within groups to create a second 
level of comparison. like groups, states must be associated 
with other events to limit application of the event conditions to 
those times when the state is active. Unlike groups, states are 
only present as an active system resource when defined. 

Care must be taken to prevent ambiguous states. This occurs 
most frequently when two events can appear on the bus 
simultaneously. Consider this example: 

when addr==0xl000 then statel 
when status==irqO then state2 

If the status comparison and the address comparison ever 
occur on the bus simultaneously, the state action is ambiguous. 
In such a case, the state actually applied is the one specified in 
the latter event statement. 

In addition, if you change to a group in which states are also 
defined, but do not specify a state as part of the group change 
action, the system defaults to state 1. 


Counters 

There are two types of event system counters: emulator, and 
on-chip. 

Emulator event counters 

The 32-bit emulator event counters, coimter 1 counter 2, are 
used to detect when events have occurred a certain number of 
times. The ctrn event tests for a counter value. The coimters 
can be set (ctrnset), incremented (ctminc), and reset 
(ctmrst) by when/then statement actions. 

On-Chip counters 

The on-chip counters, coimter A and counter B, cannot be used 
to directly define counter events. Instead, they are defined in 
event actions, where they count-down from a preset 16-bit 
value (ctradec, ctrbdec). To use these counters you must first 
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load the coimter with a value. When you use the on-chip 
counter action in an event statement, execution breaks when 
the counter equals zero. If you do not load the counter with a 
starting value, the counter counts down from zero, rolling over 
to OxfHf. From there it coimts down to zero. 

You can only use the on-chip counter action with an address 
event, an execaddress event, or an address and data event. 

Examples 

□ In the following when/then statement, counter 1 is 
incremented whenever address is 0x1000: 

when ad==0xl000 then ctrlinc 

□ In the following when/then statement, emulation stops 
when counter 1 reaches 0x10: 

when ctrl==0xl0 then break 

□ In the following commands, emulation stops when counter A 
is zero. 

ctra 10 

when ad==0xfc then ctradec 


Related commands 

For counter 1 and 2, the ctmival conunand sets the initial 
state of a counter from the command line. At pause to run 
transitions the counter can be reset to zero or it can retain its 
current value. The ctm command displays the current counter 
value. You can use the ctm command to load the on-chip 
counters A and B. 

General characteristics 

□ A when/then statement cannot contain two different counter 
actions. Use separate statements for the counter events. 

□ If you use the on-chip coimter action with an execaddress 
event, then execution breaks when the counter value is one. 
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Memory and registers 


The event system can monitor and change memory and register 
values. 

Memory and register events are always used in combination 
with other events. Valid events are address/data/status/ 
staten/trigin/trfuU. This allows you to check for the value of 
a memory location or variable, or a register after another set of 
conditions has been met. 

Memory and register values can be changed as an event system 


action. 


To: 

Use: 

set a memory value to zero 

memrst 

increment a memory value 

meminc 

set a memory value to a new value 

memset 

set a register value to zero 

regrst 

increment a register value 

reginc 

set a register value to a new value 

regset 


Each read or write to a memory location or a register requires 
a run-pause-run transition. For this reason, associating these 
events or actions with frequent events affects real-time 
operation. See page 7-23 for an discussion of real-time 
operation. 


External triggers 


Trigger input 

Event system trigger events are true when a TTL-level trigger 
input of at least one bus cycle duration is received via the BNC 
trigger input connector on the back of the emulator. 
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Trigger output 

The event system provides one TTL-level trigger oui^ut to 
generate a pulse at an external BNC connector when an event 
becomes true. The BNC connection may be used to trigger 
another emulator, an external scope or a logic ansdyzer on an 
emulator event. Normally, the voltage level on this connector 
will be high (+5V); an active trigger will drive the voltage low 
for a m i nimu m of one CPU bus cycle. 

Examples 

a To program the event S3rstem to output a trigger signal when 
address 0x34 is on the bus, enter the following 

when address==0x34 then trigout 

□ To program the event system to trace once cycle when a 
trigger input is detected, enter the following: 

when trigin then trone 

Attaching macros to event system breakpoints 

The breakcomplex (be) command associates a macro with an 
when/then statement that uses the break action, creatii^ a 
‘complex’ breakpoint. 

Examples 

Determine the when/then statement number by entering 
whenlist to display the numbered hst of when/then 
statements: 

1. when ad==0x0..3ff then group2 

2. when ad==0x9000 && status=wr then break 

3. when ad==0x9000 && data==0xfffe then break 

□ To invoke my_macro after the break action in when/then 
statement #2, enter: 

breakcomplex 2 ;iny_macro() 

□ To execute a trace-dumping macro, dumptreO, after the 
event system access break on the address plus data value in 
statement #3, enter: 

breakcomplex 3 ;dumptre() 
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Complex breakpoint process 

With a complex breakpoint, each time the specified event 
system break is encountered, the debugger: 

1. Completes the execution of the instruction at that location. 

2. Suspends program execution. 

3. Executes the macro. Depending on the macro, the debugger 
will do one of the following: 

If the macro return value is true (non-zero), the debugger re¬ 
sumes execution at the instruction immediately after the 
break. 

If the macro return value is false (zero), the debugger re¬ 
turns to command mode and displays break information. 
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Event system operation 


Break action latency 

Several factors determine the number of cycles beyond a break 
action that the processor may nm before it stops. Processor 
speed, the complexity of the instruction being executed at the 
time a breakpoint is detected, the DPI clock frequency, and the 
type of memory being used can all affect how great this latency 
may be. 

For a break action caused by an execaddr event, the break 
occurs before the instruction is executed. 

For a break action caused by all other events, the break is 
initiated in the next bus cycle after the event occurs. Several 
additional bus cycles may occur and show in raw trace as a few 
additional frames of trace beyond tke break condition. 

The break s^al appears in trace memory where the break is 
initiated. The bus cycles occurring prior to completion of the 
break action follow fbe break request, and are marked with 
the letter B in raw trace. 

On-chip access breaks (ocbrk) occur immediately after the 
load/store instruction has been executed. 

Real-time operation 

Many event system statements are processed in real time. For 
certain event and action combinations, the emulator requires a 
nm-pause-nm transition to test the event or perform the action 
specified by a when/then statement. During this time, real¬ 
time execution is affected. 

The rte command controls whether real-time operation is 
enforced. When rte is on, when/then statements that impact 
real-time execution cannot be defined. If any non-real-time 
events are enabled, rte cannot be set to on. Disable or clear any 
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non-real-time events before turning rte on. During dynamic 
run mode (drun), when/then statements may be entered and 
processed. 

The following table shows which event/action combinations re 
suit in real-time or non-real-time operation. Not all combina¬ 
tions are vaHd; see "Valid event/action combinations” on 
page 7-11 for exceptions. 


these 

events 

combined with 
these actions 

resuit in 

address 

data 

status 

groupn 

Staten 

trfull 

trigin 

trigout 

trone/tron/troff 
break/ocbrk/hwbrk/swbrk 
groupn 

ct rnrs t / c trns e t / ct mine 

real-time 

operation 

execaddr 

break 

real-time 

operation 

memory 

register 

ctrn 

trigout 

trone/1ron/1ro ff 
br eak/oebrk/hwbrk 
ctradec/ctrbdec 

non-real-tdme 

operation 

all 

memrst/memse t/meminc 
regrst/regset/reginc 
call 

non-real-time 

operation 

execaddr 

all actions EXCEPT 
break 

non-real-time 

operation 


Memory and register events, which must be paired with 
another event, are not evaluated imtil the other event is true. 
To extend real-time operation, avoid pairing memory and 
register events with events that are always true or with other 
non-real-time events. 
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Address events for code accesses 

When using an address event for a code address that is in a 
cached region, the address will appear on the bus during a 
prefetch. When this occurs, the specified actions will begin. 
This occurs prior to execution of the code. Actions will occur 
even if the code at address is never executed. 


On-chip caches 

When the processor on-chip instruction and data caches are 
used, you must make sure that instruction or data show cycles 
enabled, or the instruction/data caches will cause some access 
(address and data) events to be missed when cadbie hits occur. 
If copy back caching is enabled for the data cache, access events 
may trigger in sections of code having nothing to do with the 
access; it is just where the processor decided to copy back the 
cached data to memory. In MWX-ICE, you can use the 
showinst command to enable instruction show cycles 
(showinst indirect). The data show cycles are enabled by 
setting the DSHW bit in the processor's SIUMCR register. 
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Event system resources 

The event system uses both hardware, software, and on-chip 
resources to test for and act on the events you define. The same 
emulator resources are used to support both breakpoints and 
the event system. 

MWX-ICE allows up to 32 when/then statements to be defined. 
Depending on the events and actions specified, different 
numbers of emulator resources are required by each when/then 
statement. 

In general the emulator manages these resources, warns you 
when it makes adjustments, and presents an error when 
resources are exhausted or when you attempt something that 
creates a conflict. Only if you are frequently exhausting 
resources do you need to review the information in this section. 


Resource aiiocation 


Definitions 

The following terms are used to explain hardware resource 
allocation. The term ads.event stands for an address, data, 
status event. 
ads. event 

Any event expression that uses the AND operator (&&) to 
combine address, data, or status events. Event expressions 
that are combined using the OR operator (| |) are considered 
to be separate ads.events. For example, ioxxr ads.events are 
shown below: 

when ads.eventl || ads.event2 
when ads.events 
when ads.event4 

simple ads. event 

An ads.event with no address/data ranges or negations. For 
example: 

when ad==0x0034 &=0x00ff 
when status==rd 
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when ad==OxfGOO && status==rd 

when ad==OxfeOO && data==0x5555 && status==rd 

complex ads^event 

An ads.event with address ranges or negations. For example: 
when adl=0xfe00..Oxfeff && status==rd 

hardware event comparator 

Hardware comparators in the emulator used for detecting 
when/then statement address, data, and status events and 
access breakpoints. 

Resource allocation 

□ The system makes available 16 hardware event 
comparators. 

□ Simple ads, events use one event comparator. 

□ Complex ads.events that include only ranges, use two event 
comparators. 

□ Complex ads.events that include address/data negations 
with no mask and a status event, use four event 
comparators. 

□ Complex ads.events that include address/data negations 
with a mask and a status event, use multiple event 
comparators, depending on the mask value. 

□ Only enabled when/then statements, whether global (no 
group in the when clause) or associated with a single group, 
use hardware event comparators. 

□ Access breakpoints (ba, br, bw) consume an event 
comparator, limiting the comparators available for event 
system use. 

□ A total of 50 breakpoints or events can be defined. 

□ Up to 10 access breakpoints can be defined. 

□ Up to 32 event statements can be defined. 

□ Up to 16 actions can be included in a single when/then 
statement. 
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Using resources wisely 

a When/then statements are automatically enabled when 
defined. Use whendisable to disable any when/then 
statement that does not apply to the current portion of the 
debugging session. Use whenenable to re-enable when/ 
then statements. 

□ If event resources run short, save (whenlist filename) and 
clear (whenclr) any when/then statement that does not 
apply to the current portion of the debugging session. This 
frees its allocated resources for other events. 


Additional information 

a The tutorial in Chapter 10 offers additional practical 
examples. 

□ Help provides detailed descriptions of all the commands 
mentioned in this chapter, as well as structured “browse 
sequences” that organize the Help topics by subject. 


7-28 


MWX-ICE User’s Manual (Windows) 



Chapters 

Support for MPC8XX Registers _ 

The SuperTAP system enables display and modification of all 
MPC8XX family registers. 


Contents Page 


Using the set of initialization registers 8-2 

Support for MPC8XX family registers 8-9 

Viewing and modifying MPC8XX family registers 8-10 
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Using the set of initialization registers 

The SuperTAP maintains a copy of the values stored in some of 
the processor’s chip-select and pin assignment registers. This 
copy is called the set of initialization registers, or INTTKEGS, 
because it is used whenever you resume operation after a 
target-generated or MWX-ICE command-driven processor 
reset. The INTTREGS must match the values that the processor 
chip-select and pin-assignment registers have after you run 
your initialization code. 

Why do I need to set up the initregs? 

The INITREGS feature provides a way of decoding the 
multiplexed control pins, disabling the software watchdog 
timer, and making MWX-ICE memory operations possible 
immediately after a processor reset. For these reasons, you 
must specify the INTTREGS at the beginning of each session as 
described in the following sections. 

Because the processor multiplexes several control signals on 
the same pin, it is difficult to determine what functions the pins 
have been programmed for. The processor’s chip-select and 
pin-assignment registers provide the information needed to 
decode the control pins and address lines, but they are 
unavailable while the processor is running. In addition, these 
registers are cleared whenever the processor is reset. 

Note that, when discussing the initial registers, there are two 
items which are being saved: the list of registers to manage, 
and the list of the values of those registers. In most contexts 
below, the discussion will focus on manipulating the list of 
values, except where noted. Unless you specify a different Ust 
of registers, the system-default hst will be used. 
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How do I turn the initregs feature on or off? 

In the command window, type the command initregs on to 
enable this feature (the default is on). Once you have set up the 
INITREGS for your target, you should leave this feature on 
except when you are debugging the boot code itself. The 
command initregs off disables this feature. 

How do I see the current “state” of the initregs feature? 

Enter the command initregs (without an argument) to show 
the current state of this feature. 

Where are the initregs values stored? 

When you use the initregs save command, MWX-ICE reads 
the processor registers and creates an internal copy of the 
registers and then saves the register values to the file specified, 
or to the default file, if no file was specified. You can edit this 
file to change values, or to add or remove registers firom the list. 
You should use care when editing this file, however, as some of 
the registers can only be written once, and the order the 
registers appear in the file can be important. For example, the 
UPMx registers should be initialized before the MxMR is 
written to turn on DRAM refresh, which immediately uses 
UPM* values. 

When you save or restore the register values without specifying 
a path and filename, MWX-ICE looks in specific directories for 
a data file. The name of the file is iregsxx»r.dat (where the xxx 
is replaced by your processor type: 860, 821, and so forth). 
When the INTTREGS featme is enabled (on), MWX-ICE 
automatically uses the registers and values firom this file. 

MWX-ICE searches the directories for the INTTREGS data file in 
the following order: 

□ currentjlirectory \ amc \ ST8XX \ iregSKXx,dat 

□ $XRAYMASTER\amc\ST8XX\iregs*3cx,dat 

□ C:\ST8XX\amc\ST8XX\iregsxaR*:.dat 
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How do I set up the initregs? 

There are two ways to set up the INITREGS: 

□ Run boot code that sets up the chip-select and 
pin-assignment registers, and then copy the processor's 
registers into the INTTEIEGS. 

□ Edit a copy of the iregs:i:x::ir*dat file to have the correct 
values for your target. You can then restore the INITREGS 
from this file. 

Running boot code in ROM 

If you have startup code in your target ROM, you can run this 

code to set up the chip-select and pin-assignment registers. 

Once youVe run your initiahzation code, you can then copy the 

processor's registers into the ENTTREGS. 

(Note that the following commands work with the 

system-default hst of registers). 

> To set up the initial registers: 

1. Set up your environment and start MWX-ICE as described 
in Chapter 2. Be sure to read the section "Software watchdog 
timer" on page 2-23. 

2. Run your initialization code: t 3 rpe go in the Command 
window or chck the Go button. 

3. Chck the Stop button. 

4. Type initregs on (imless this has already been done). 

5. Type initregs save \filename] to make a permanent copy of 
the initregs in a file. 


The file saved is an initregs data file. It can be edited to change 
either the hst of registers or their values. If you don't specify a 
filename, the name iregsxxjir^dat is used (where the ocxx is 
replaced by your processor type: 860, 821, and so forth). This 
file is created in one of the directories hsted in "Where are the 
initregs values stored?" on page 8-3. 
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Editing a copy of the iregsxxx.dat fiie 

If you don’t have boot code in ROM to run, you can edit the 
initregs file to match your target system. Making a copy of the 
default initregs data file is a versatile way to mans^e your chip 
select and pin assignment registers if you need to change them 
frequently. Using several initregs data files, you can change 
the values for these registers without having to type in a 
complete register set each time you want to change them. 


Note 



The default file is called iregsxxair.dat.def (where the xxx is 
replaced by your processor type: 860,821, and so forth). The 
default file is located in install_dir\ame\ST8XX. The original 
.def file should never be modified. This file sets up the registers 
for isolation mode. In isolation mode the SuperTAP is not 
connected to a target. In the s£une directory, there are three 
other initregs files: iregs860.dat.ads and iregs860.dat.ainc. 
These files set up the registers for use with the Motorola ADS 
board and the AppHed Microsystems test target. To use those 
files, just make a copy of them with the name iregs860.dat. 
The third file is iregs860.dat.all; it lists almost every 
configuration register for the MPC860. To use this file, read the 
comments in the file and edit it as necessary. Then make a copy 
with the name iregs860.dat. 
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Use the following steps to edit the .dat files. 

>■ To edit the ENTTREGrS data file: 

1. Copy the default iregsxxx.dat.def file and save it as 
iregsxxx.dat in the installjiir\smc\S'^8'XX. directory. 

2. Edit the iregsxxx.dat file as plain (ASCII) text with any 
text editor or word processor. 

3. Define each register on a separate line. 
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Choose the registers and values appropriate for your system. 
To add comments, begin a line with the pound sign (#). 

# MPC860 Initregs file 

# Isolation mode setup. 

# Customize for a specific target 

# 

# Turn off the MPC860 internal 

# software watchdog timer 
SYPCR=Oxffffff80 

# Set the Recoverable Interrupt 

# so that maskable breaks work 
MSR=0x42 


4. Save the file as plain ASCII text. 

With the initial-register feature enabled (initregs on), the 
file iregs«»»:.dat is automatically loaded following a reset. 
You can also save the file using a different filename. If you 
use a different filename, you need to reload the register val¬ 
ues exphcitly using the initregs restore commamd. 

Restoring the initial-register values 

If you’ve set up and saved the INITREGS for your target using 
the default filename for your processor (ire|^axr.dat), you 
won’t need to exphcitly restore the values from the file as long 
you’ve set initregs on and saved your configuration using 
consave or the Emulator Configuration window. 

If you’ve used a filename or path that is different firom the 
default youll need to restore the values firom the file using the 
initregs restore command. Once restored, those registers and 
values are used following a processor reset. 

> To restore the initregs: 

1. If you haven’t already done so, enable the initregs feature. 
From the Co mm and window, type initregs on 

2. Type initregs restore fUename 

3. Reset the processor, type reset in the Command window. 
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Be sure to use initregs restore command instead of the 
include command to restore INTnaEGS. 


Using the initregs command 

The initregs command controls Idle updating of the system 
interface unit (SIU) registers, and others, from the LMTEREGS 
after an MWX-ICE reset command or a target-generated 
processor reset. Once you have initialized your INITREGS, leave 
the feature enabled (initregs on) unless you are debugging the 
boot code itself. 

Syntax 

initregs [ op ti on] 


JD G 
ct> c 


The options to the command are as follows: 

Option Description 

off After a processor reset, the registers come up 

in their default reset state. No attempt is 
made to reprogram them. 

on Loads the INITREGS values into the processor 

upon a processor reset. This is the default. 

<none> Shows whether or not the feature is enabled. 

save Writes the INTTREGS to a file. Does not affect 

the processor's register values. 

restore Reads INITREGS from a file. Does not affect 

the processor’s register values. This option is 
the only way to change the list of registers 
from the default hst. 
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Enabling the initregs feature 

You can enable the initxegs feature from the command line 
while MWX-ICE is running. 

> To enable INITREGS 

1. Set up and initialize the initial registers as described in 
previous sections. 

2. From the Command window, type initregs on 

3. If you want to program the processor registers with the 
INTTREGS values, reset the processor by typing reset in the 
Co3nmand window. 

What happens when the INITREGS feature is enabled? 

At power up and after an MWX-ICE or target-generated 
processor reset, the chip-select information in the processor's 
register set is reprogrammed. 

With initregs on, the reset sequence is as follows: 

1. Reset the processor. 

2. Copy all initial registers, if initialized, to the corresponding 
processor registers, which enables chip-selects, etc. 

Disabling the initregs feature 

You can disable the INTTREGS feature from the command line 
while MWX-ICE is nonning. To start MWX-ICE with INTTREGS 
disabled, save the configuration to startup.inc. 

> To disable INITREGS: 

■ From the Command window, type initregs off 

What happens when the INTTREGS feature is disabled? 
The command initregs off allows the target software to 
configure the chip selects rather than having them 
pre-configured at reset. This is useful when debugging boot 
code. 
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Support for MPC8XX family registers 

MWX-ICE provides direct, point-and-click access to all 
registers of the supported processors. 

Setting up the register sets 

Before emulating, you must configure the emulator and 
debugger for the processor to be used. This also controls which 
registers can be accessed. 

To begin emulation, you must select the correct processor at 
MWX-ICE startup using the MWX-ICE Startup Options 
Editor. The Startup Editor saves your selections to a file 
(MWXCFG is the default file). The debugger looks for this file 
at startup. 

> To configure the processor 

1. Chck the Start Menu, point to AppUed Micros 3 ^tems, then 
point to MWX-ICE SupeiTAP, then cli(h, the MWX-ICE 
Startup Options Editor. 

2. Select the type of processor being emulated from the 
Processor list. 

3. Specify additional startup options, if needed. 

4. Choose OK 
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Viewing and modifying MPC8XX family registers 

Once a MWX-ICE is configured for the correct processor, you 
can use a variety of tools to access the registers. 


Viewing registers 

There are three methods to view registers: 


Sear5^ 


Keywords: 
Register window 
Register mnemonics 


SETREG 


□ From the Displays menu, use the Registers menu to bring up 
a window displaying the group of registers of interest. 
Depending on the processor, you can select among general, 
memory control, system control, CPM, MMU, PCMIA, UPM, 
and other groups. 

□ Use the CPU Browser to get error-protected, point-and-click 
display and control of all speciahzed register bits. From the 
Displays menu, select CPU Browser; then select the 
register(s) of interest. 

□ Use the cexpression command to display individual 
registers. 


Modifying registers during pause 

There are three methods for modifying registers: 


□ Click the register in the Registers window to bring up a 
dialog box that accepts new values. 


□ Within the CPU Browser windows, use the bit-configuration 
menus to select options for the registers. 

—or— 

□ From the command line, use the setreg command to enter a 
new value: 

setreg ^register_name=value 

For detailed explanations, see Help for descriptions of the 
Registers and CPU Browser window and the setreg command. 
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Note 



When the CPU Browser window is open, all entries made using 
any register controls are checked for errors. If the new values 
are entered using setreg or the registers windows, the value is 
applied before the error dialog is presented. If the change is 
made using the CPU Browser, the new value is not applied 
until you respond to the warning dialog. The exception is an 
invahd value that is corrected by the processor core itself. 
Invalid entries in some registers do not trigger an warning 
because the processor ignores the invalid bits. With rgverify 
on, a warning is generated when the value written is not 
applied to the register. 


Modifying registers during operation 

The event system provides means to test for register values and 
to set, increment, or clear registers as the result of specified 
conditions. Chapter 7 covers event system features and use. 
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Chapters 

MWX-ICE Command Quick Reference 


MWX-ICE is based upon tihe Microtec Research XRAY 
simulator (XHS). MWX-ICE supports most XRAY commands 
and adds commands to support emulation. This chapter lists 
the commands by function and indicates which of these 
commands are supported by both MWX-ICE and XRAY and 
which simulator commands are not valid in MWX-ICE. 


Contents Page 


Help 9-2 

Session control 9-4 

Window control 9-5 

Memory and file handling 9-6 

Controlling execution and using breakpoints 9-11 

Capturing and displaying trace 9-13 

Programming the conditional event system 9-15 

Displaying status or information 9-17 

Emulator configuration 9-19 

Diagnostics 9-20 

Using macros 9-21 

Symbol and expression commands 9-22 

Simiilating port VO and interrupts 9-23 

UtiUty commands 9-24 

Connection and configuration commands 9-25 

XRAY commands not supported in MWX-ICE 9-26 


Check the index if you are imsure of the category for a specific 
command. See the following section on Help for information on 
how access to complete command descriptions. 
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Complete command descriptions are provided in the online 
help system. Command descriptions may be found several 
ways: 

If you... Do this... 

Don’t know the 
command name 


—or— 

Chck Search 

Search for topic, functional name 
—or— 

Click Contents 

Chck on appropriate feature/function 
Look for commands mentioned within text 

Know the 
command name 


—or— 

Chck Search 

Enter command jiame in the Search box 
Chck Find Topics button 
Chck commandjiame 
Chck Go To button 

See Chapter 2 for an overview and for information on starting 
Help without starting MWX-ICE. 


Chck Contents 

Chck Keyboard Commands (Alphabetical 
Listing) 

Chck command name 


Chck Contents 

Chck Keyboard Commands (Functional 
Groups) 

Locate appropriate functional group 
Chck command name 
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Command groups 

Each category begins with a brief description of the functions 
of that group. The full command name is bulleted at the left. 
The description and syntax column provides a brief 
explanation of the commands function and a full expression of 
all syntactical elements. If an abbreviation exists for the 
command, it is used in the S3nitax example. Because not all 
commands can be used with MWX-ICE or the XHS simulator, 
identifiers (■) are placed in the columns that apply. 


Entering commands 

From the Command window, you type MWX-ICE commands in 
the Enter Command box and then click the Enter Command 
button or press <Retum>. Any combination of upper-case and 
lower-case letters can be used in commands. Some functions 
can also be performed in specialized windows or menus. 
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Session control 


These commands provide session-level functions. 


Command 

Description/Syntax 

MWX-ICE 

andXHS 

journal 

Records a debugger session in a file, 
j [/a] [off 1 on=“filename"] 

■ 

log 

Records debugger commands and errors in a file, 
log [/a] [off 1 on="filename"] 

■ 

mode 

Selects debugger mode (high or assembly), 
m [high | assembly] 

■ 

option 

Sets debugger options for this session. 

OP [option_najne = {value| symbol} ] 

Options and arguments: 

ALIGN={ONlOFF} 

ANIMATE={ON|OFF) 

CPtJ=Read-only display of processor 
DEMANDLOAD={ON|OFF} 

EMULATOR=Read-only display of boot option 
FRAMESTOP={ON|OFF} 

INCECHO={ON1 OFF} 

LINES={ON|OFF) 

LOADDEFAULTS={LOAD command options strincf) 
RADIX={HEX 1 DECIMAL} 

SYMBOLS={ON|OFF} 

TYPECHECK={ON|OFF) 

■ 

quit 

Terminates a debugging session, 

Q [y] 

■ 

setstatus dir 

Sets the current directory, 
ss dir [=newi.IocaI_dir] 

■ 

setstatus environment 

Overrides the XRAY environment variable, 
ss env[="pathl:path2;path3“] 

■ 
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Window control 

These commands enable configuring, calling up, and 
customizing the debugger windows. 


Command 

Description/Syntax 

MWX-ICE 

XHS 

mode 

Selects debugger and display mode Qiigh or 
assembly) for active window, 
m [high | assembly] 

■ 

■ 

vactive 

Activates a window, 
va (window_number) 

■ 

■ 

vclear 

Clears data from a window. 

VC [windowi_number] 

■ 

■ 

vclose 

Removes a user-defined window, 
vclo iwindow_number] 

■ 

■ 

vmacro 

Attaches a macro to a window, 
vm window_number [, macro_name () ] 

■ 

■ 

vopen 

Creates a window or changes sizes. 

VO [window^number, screen_number, 
tr, Ic, br, rc] 

■ 

■ 

vsetc 

Sets the cursor position for a window, 
vse window_jiumber, line, column 

■ 

■ 
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Memory and file handling 

These commands enable configuration, display and 
modification of target and emulator memory and uploading 
and downloading of files. 


Command 

Description/Syntax 

MWX-ICE 

XHS 

Amddevice 

Specifies the flash memory to be programmed, 
(case-sensitive) 

Amddevicel {base_addr, "space”, width) 
Imddevice2 {hase__addr, "space”, 
bySorl 6, width) 

■ 


address 

Specifies logical or physical addresses for 
memory accesses. 

ADDRESS access_type 
[logical_code|logical_data| 
physical] 

■ 


asm 

Single line assembler, 
asm [org address] 
asm [mnemonic [operand] [, 
operand] . . . ] 

■ 


compare 

Compares two blocks of memory. 

COM [/R] [address__range, address] 

■ 

■ 

copy 

Copies a memory block. 

COP address_range, targefc_address 

■ 

■ 

crc 

Calculates a CRC for a range of memory. 

CRC addresStrange [ / memory^space] 

■ 


disassemble 

Displays disassembled memory (assembly 
mode). 

disa [address] 

■ 

■ 

dnl 

Downloads non-DWARF/ELF hex file to 
target. 

dnl "filename" [, offset] 

■ 


dnlfmt 

Specifies download format, 
dnlfmt fojnnat 

■ 
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Command 


Description/Syntax 


MWX-ICE XHS 


diil__gap 

Specifies maximum b 3 rtes between contiguous 
blocks in downloads, 
dnl^gap [0-1024] 

■ 


dump 

Displays memory contents, 
du [/b 1 /w 1 /I] [address | 
a ddress_range ] 

■ 

■ 

EraseDevice 

Erases the device identified by Amddevice or 
Intelcieuicc. (case-sensitive) 

EraseDevice 0 

■ 


error 

Sets include file error handling, 
er = {quit | abort | continue) 

■ 

■ 

expand 

Displays all local variables of a procedure, 
exp [ stack_l evel ] [, window_number] 

■ 

■ 

fiU 

Fills a memory block with values, 
fil [/b 1 /w 1 /I] addresstrange 
[= {expression | 
expression^string) ] 

■ 

■ 

fopen 

Opens a file or device for writing, 
fo [/a] [/r] window_jiumber, 

" filename" 

■ 

■ 

^rintf 

Prints formatted output to a window or file, 
f window__number, " foimat__string" 

[ , argument] . .. 

■ 

■ 

include 

Reads in and processes a command file, 
inc "filename" 

■ 

■ 

initregs 

Initializes processor diip-select and pin 
assignment rasters. 

INITREGS [ON | OFF] 

INITREGS [SAVE [filename]] 

INITREGS [RESTORE [filename]] 

■ 
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Command 

Description/Syntax 

MWX-ICE 

XHS 

hxteildevice 

Specifies the flash memory to be programmed, 
(case-sensitive) 

Inteldevicel {base_addr, "space”, 
width) 

Inteldevice2 {base__addr, "space”, 
by8orl6 ,width) 

■ 


list 

Displays source code. 

1 [line_number \ pro cedar e_name \ 
^stack_level] 

■ 

■ 

load 

Loads an object module for debugging, 
loa [/a][/c][/ni][/np | /sp][/ns] 
absolute_filename [, root] 
[Scbase_addr] [; section 
[,section]...] 

■ 

■ 

LockDevice 

Disables flash programming (case-sensitive). 
LockDevice 0 

■ 


map 

Defines a region of overlay or target memory. 
MAP address^range \ start, .^length 
[/inode] [=type] 

■ 


mapclr 

Clears overlay memory map. 

MAPCLR 

■ 


maplist 

Displays or saves cvurent memory mappings. 
MAPLIST [ filename ] 

■ 


memvars 

Displays memory access variable values. 
MEMVARS 

■ 


overlay 

Selects target or overlay as memory for 
various actions. 

OVERLAY access_type [ON|OFF] 

■ 


ovreadthru 

Controls whether reads to overlay also go to 
target memory, 
ovreadthru [ ON | OFF ] 

■ 


ovwritethru 

Controls whether writes to overlay also go to 
target memory, 
ovwritethru [ON|OFF] 

■ 



9-8 


MWX-ICE User’s Manual (Windows) 











Command 

Description/Syntax 

MWX-ICE 

XHS 

reload 

Reloads absolute file image, 
rel [/c] [/d] [/r] [root] 

■ 

■ 

RemoveDevice 

Removes flash device specification, 
(case-sensitive) 

RemoveDevice ( ) 

■ 


restart 

Resets program counter to the program 

starting address. 

rest 

■ 

■ 

restore 

Restore memory (XHS) and registers (MWX- 
ICE and XHS) from a file, 
res to [save_filenaine] 

■ 

■ 

rgverify 

Enables verification of writes to registers, 
rgver [on | off] 

■ 

■ 

save 

Saves current memory (XHS) and rasters 
(MWX-ICE and XHS) to file, 
sa [save__filenajne] 

■ 

■ 

setmem 

Changes the values of memoiy locations, 
sm [/b 1 /w 1 /I] address 
[ = { express! on | express! on_s tr!ng) 

[, { express! on | express! on_str!ng) ] 

. . .]] 

■ 

■ 

setreg 

Changes the contents of a register, 
sr @reg!ster_name -value 

■ 

■ 

size 

Sets the size for memory accesses, 
size [memory__access_type [1 1 2 | 4] ] 

■ 


test 

Examines memory area for invalid values, 
te [/b 1 /w 1 /I] [/r] 

[address_range [= {express!on | 
express!on__str!ng) ] ] 

■ 

■ 

UnlockDevice 

Enables flash programming. 

(case-sensitive) 

UnlockDevice () 

■ 
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Command 

Description/Syntax 

MWX-ICE XHS 

upl 

Uploads non-DWARF/ELF hex file to host, 
upl " fil ename “ , addresstrange 

■ 

uplfmt 

Specifies upload format: Intel, SREC, XTEK 
(extended Tektronics hex), 
uplfmt format 

■ 

verify 

Memory read-after-write verify switch, 
verify [on | off] 

■ 

when 

Breaks on memoiy or register values; alters 
memory or register values as an event system 
action. 

WHEN event &.&. memory address=value 
then ... 

WHEN event && register^value then 

■ 


WHEN event then 
memrst | meminc | memset 
addressl=value] 

WHEN event then 
regrst|reginc|regset 
regi s t er_name [=val u e] 


xlate 

Converts logical address to physical address. 
XLATE address 

■ 


9-10 


MWX-ICE User’s Manual (Windows) 









Controlling execution and using breakpoints 

These commands provide basic execution control and access 
and instruction breakpoints for initial debugging. 


Command 

Description/Syntax 

MWX-ICE 

XHS 

bptJHPe 

Specifies the type of breakpoint 
(software, on-chip, or emulator hardware), 
bp type [hw | sw | onchip | choose ] 

■ 


breakaccess 

Sets an access breakpoint. 

BA [ address | address^rangfe] 

[; macro_name () ] 

■ 

■ 

breakcomplex 

Attaches a macro to an event system break. 

BC n }macro_name{) 

■ 

■ 

breakinstruction 

Sets an instruction breakpoint, 
bi [address \ address_range] 

[ ;macro_name () ] 

■ 

■ 

breakread 

Sets a read access breakpoint. 

BR [address | address_range] 

[ ;macro_name () ] 

■ 

■ 

breakwiite 

Sets a write access breakpoint. 

BW [address | addressprange'\ 

[ ;macro_name {) ] 

■ 

■ 

clear 

Clears a breakpoint, 
cl [breakpoint^number \ 
breakpoln t_nuinber_range] 

■ 

■ 

drun 

Starts executing and enter dynamic run mode. 
DRUN 

■ 


dstop 

Exits dynamic run mode. 

DSTOP 

■ 


dupdate 

Starts polling and sets fi-equency in dynamic 
nm. 

DUPDATE [n] 

■ 
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Command 

Description/Syntax 

MWX-ICE 

XHS 

go 

Starts or continues program execution, 
g [ =s tart_address [, ] ] [ teiiip__break 

[%%passcoun t [,]]... ] [; macro_name {) ] 

■ 

■ 

gostep 

Executes macro after each instruction step, 
gos macro_name{) 

■ 

■ 

pause 

Pauses simulation or emulation for specified 

seconds. 

pa [n] 

■ 

■ 

poreset 

Resets the processor with a power-on reset, 
poreset 

■ 


reset 

Resets PC and synchronizes with target reset, 
reset 

■ 

■ 

restart 

Resets the program starting address, 
restart 

■ 

■ 

serial_core 

Controls serialization of CPU Core. 
serial_core [ON|OFF] 

■ 


sit 

Stops in target loop address, 
sit [address] 

■ 


sitstate 

Selects emulation stop method, 
sitstate [ON|OFF] 

■ 


step 

Executes a specified number of instractions or 
lines. 

s [=start_addr [, value] | value] 

■ 

■ 

stepover 

Steps, but executes through procedures, 
so [=start__addr [, value] | value] 

■ 

■ 
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Capturing and displaying trace 

These commands capture bus conditions and display them in 
assembly, C-source or mixed source-assembly. 


Command 

Description/Syntax 

MWX-ICE XHS 

drt 

Displays raw trace. 

DRT [start^line | start, ,end_line] 

■ 

drtdata 

Limits display of the data bus. 

DRTDATA [NOTALLjALL] 

■ 

drtfuU 

Displays all fields in trace frames. 

DRTFULL [ONjOFF] 

■ 

dt 

Displays disassembled trace. 

DT [start\start. .end] 

■ 

dtb 

Displays disassembled trace from latest to 
earlier. 

DTB 

■ 

dtf 

Displays disassembled trace from earlier to 
later. 

DTF 

■ 

dxinsert 

Interleaves raw and disassembled trace. 
DXINSERT[ON1 OFF] 

■ 

dxlabels 

Shows s 3 mibols for branch destinations. 
DXLABELS [ON|OFF] 

■ 

ppt 

Traces peeks and pokes. 

PPT [ON|OFF] 

■ 

showinst 

Provides show cycle control. 

SHOWINST [NONE|INDIRECT[FLOW|ALL] 

■ 

siga_mux 

Selects IRQ (0,1, 7) or External LSA Bits (0,1, 
7). 

SIGA_MDX [IRQ | LSA] 

■ 

sigfo.mux 

Selects IRQ (2:6), RVS* DP(0:3), LSAbits (2:6), 
or WP. 

SIGB_MOX [LSA|WP|PCMCIA|DP|RSV|IRQ] 

■ 
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Command 

Description/Syntax 

MWX-ICE XHS 

timclk 

Sets the timestamp resolution. 

TIMCLK 

[40ns 1200ns|lus|lOus|lOOus11ms110ms| 
100ms] 

■ 

trace 

Dynamically enables/disables trace capture. 
TRACE [ON|OFF] 

■ 

trbase 

Specifies offset timestamp base frame. 

TRBASE frame_number 

■ 

trclr 

Clears trace buffer. 

TRCLR 

■ 

trdisp 

Sets trace display to assembly, source, or both. 
TRDISP [ASM|SRC1 BOTH] 

■ 

trcext 

Enables external trace (^des 

TRCEXT [ON|OFF] 

■ 

trframes 

Displays number of trace frames in buffer. 
TRFRAMES 

■ 

trinit 

Selects trace initial state at run. 

TRINIT [ON1 OFF 1 CURRENT] 

■ 

trqual 

Selects bus or clock cyde capture. 

TRQUAL [BDS|CLK|DXQUAL] 

■ 

trrunclr 

Enables/disables trace clear-on-nm. 

TRRUNCLR tON|OFF] 

■ 

trstamp 

Controls timestamp display in trace. 

TRSTAMP [INTERVAL 1 OFFSET] 

■ 

trsys 

Provides d 3 mamic control of trace subsystem. 
TRSYS [ON|OFF] 

■ 

tsrch 

Search trace memory for patterns. 

■ 


TSRCH [ trace_range ], 
[addr=value[Sc=mask] ] 

[&& data=value[&=mask]] [&& 
stat=mnemoni c] 
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Programming the conditional event system 

These commands provide the setup and control functions for 
the conditional event system provided by the SuperTAP. With 
these you can specify nested sequences of possible target 
conditions and then trigger various responses. 


Command 

DescriptionySyntax 

MWX-ICE XHS 

breakcomplex 

Executes a macro following an event system 
break. 

BC 21 }jnacro_naine{) 

■ 

ctm 

Displays coimter n value. 

CTR 21 

■ 

ctmival 

Specifies initial value of counter n at run. 
CTRnIVAL [CURRENT1 RELOAD] 

■ 

evtvars 

Displays internal debugger variable values. 
EVTVARS 

■ 

group 

Displays/selects active event group. 

GROUP [ 22 ] 

■ 

siga_mux 

Selects IRQ (0,1, 7) or External LSA Bits (0,1, 
7). 

SIGA_MaX [IRQ 1 LSA] 

■ 

sigb_mux 

Selects IRQ (2:6), R^^*, DP(0:3), LSAbits (2:6), 
or WP. 

SIGB_MDX [LSA|WP|PCMCIA|DP|RSV|IRQ] 

■ 

state 

Displays/selects active event group. 

STATE [21] 

■ 

when 

Defines a when/then statement. 

when event_e^ression(s) then action 

i,action] 

■ 

whencbr 

Clears when/then statements. 
lAJHENCLR [ 22 U 2 nber [,number \ 
number, .number \ ALL] 

■ 
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Command 

Description/Syntax 

MWX-ICE XHS 

whendisable 

Disables when/then statements. 
WHENDISABLE [number [,number \ 
number.. number | ALL] 

■ 

whenenable 

Enables when/then statements. 
WHENDISABLE [number [,number \ 
number,, number | ALL] 

■ 

whenlist 

Displays when/then statements. 

WHENLIST [filename} 

■ 
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Displaying status or information 

These commands write information to a window or file to 
monitor the status of the various features of the program, 
emulator, or debugger. 


Command 

Description/Syntax 

MWX-ICE 

XHS 

disassemble 

Displays disassembled memory (assembly 
mode), 

DISA [address] 

■ 

■ 

down 

Moves down specified number of stack levels. 
DOW [levels] 

■ 

■ 

dump 

Displays memory contents. 

DU [/B 1 /W 1 /L] [address | 
address__range] 

■ 

■ 

emuvars 

Displays emulator variable values. 

EMUVARS 

■ 


evtvars 

Displays event system variable values. 
EVTVARS 

■ 


expand 

Displays all local variables of a procedure. 

EXP [stack_level] [, window_nuinber] 

■ 

■ 

fopen 

Op>ens a file or device for writing. 

FO [/A] [/R] window_nuittber, 

"filename'* 

■ 

■ 

fprintf 

Prints formatted output to a window or file. 

F window_number, ” fonnat^string" 

[, argument] , . . 

■ 

■ 

hwconCLg 

Displays hardware name and version. 
HWCONFIG 

■ 


list 

Displays source code. 

L [line^number j procedure_name \ 
(^stack^level] 

■ 

■ 

memvars 

Displays memory access variable values. 
MEMVARS 

■ 
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Command 

Description/Syntax 

MWX-ICE 

XHS 

mode 

Selects debugger mode (high or assembly). 

M [HIGHIASSEMBLY] 

■ 

■ 

monitor 

Monitors variables. 

MON [/H I /S I /T] {expression | 
express! outrange } 

[; di spl ay_l ine | ; di spl ay_l in e__range 
[, display_line_range] . . . ] 

■ 

■ 

nomonitor 

Discontinues monitoring variables. 

NOMO [nuznber | nuniber^range] 

■ 

■ 

printf 

Prints formatted output to Command window. 
PRINTF " forma t^string” [, argumen t] 

■ 

■ 

printsymbols 

Displays symbol information. 

PS [/C|/D|/E|/F|/M|/Rl/T|/W] 

[name[*]] [\|\\i*] 

■ 

■ 

printtype 

Displays symbol type. 

PT symbol_name 

■ 

■ 

printvalue 

Prints the value of a variable. 

P [/H I /S I /T] {expression \ 
express! on^range } 

■ 

■ 

status 

Shows the status of the debugger or tai^et. 

STAT [ALL I XRAY j HELP | SEARCH ] 

■ 

■ 

tgtmode 

Displays target connection mode. 

TGTMODE 

■ 

■ 

up 

Moves up stack specified number of levels. 

UP [levels] 

■ 

■ 

xicevars 

Displays internal debugger variable values. 
XICEVARS 

■ 


xlate 

Converts logical address to physical 
address. 

XLATE address 

■ 
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Emulator configuration 

These commands control the basic operation of the emulator. 


Command 

Description/Syntax 

MWX-ICE XHS 

bclock 

Enables the buffering of CLKOUT. 
bclock [on I off] 

■ 

bte 

Enables/disables emulator bus timeout. 

BTE [ONI OFF] 

■ 

emuvars 

Displays emulator variable values. 

EMOVARS 

■ 

isomode 

Enables/disables isolation mode. 

ISOMODE [ONI OFF] 

■ 

poreset 

Resets the processor with a power-on reset, 
poreset 

■ 

reset 

Resets PC and synchronizes with target RESET. 
RESET 

■ ■ 

rte 

Enables/disables realtime enforcement. 

RTE [ONI OFF] 

■ 

runjpoU 

Sets number of polls per second during run. 
RUN__POLL [n] 

■ 

run-time 

Sets maximum run time before forcing a break. 
RUN-TIME [n] 

■ 

sit 

Stops in target loop address. 

SIT [address] 

■ 

sitstate 

Selects emvdation stop method. 

SITSTATE [ON|OFF] 

■ 
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Diagnostics 


These commands provide a variety of diagnostic routines for 
target testing. 


Command 

Description/Syntax 

MWX-ICE XHS 

diag 0 

Simple target ram test. 

DIAG 0, address_range [#count] 

■ 

diag 1 

Complex target ram test. 

DIAG 1, addresstrange [#coimt] 

■ 

diag 2 

Continuous reads from target memory. 

DIAG 2, address_range 

■ 

diag 3 

Continuous writes to target memory. 

DIAG 3, address_range=data 

■ 

diag 4 

Writes alternating pattern to target memory. 
DIAG A, address_range=data [=aifc_data] 

■ 

diag 5 

Continuous writes of rotating data value to 
target memory. 

DIAG 5, address_range=data 

■ 

diag 6 

Continuous writes with read-after-write. 

DIAG 6, address_range=data 

■ 

diag 7 

Writes incrementing value to target memory. 
DIAG 7, addresstrange 

■ 

diag 8 

Sends continuous stream of reset pulses. 

DIAG 8 

■ 


9-20 


MWX-ICE User’s Manual (Windows) 














Using macros 


The macro commands define and display macros. 


Command 

Description/Syntax 

MWX-ICE 

XHS 

breakaccess 

Sets an access breakpoint. 

BA [address [ addresstrange] 

[; macro_name () ] 

■ 

■ 

breakcomplex 

Attaches a macro to an event system break. 

BC n ;macro_name() 

■ 

■ 

breakinstruction 

Sets an instruction breakpoint. 

BI [address | addresstrange] 

[ ;]nacro__name () ] 

■ 

■ 

breakread 

Sets a read access breakpoint. 

BR [ address | addresstrange] 

[ ;macro_name {) ] 

■ 

■ 

breakwrite 

Sets a write access breakpoint. 

BW [address | address_range] 

[ ;macro_jiame () ] 

■ 

■ 

define 

Creates a macro. 

def [jnacro_type] inacro_naine 
([parameter_Iist]) 

\,param_defini tions] 

{ 

macro__body 

) 

■ 

■ 

error 

Sets command file error handling. 
error=[quit | abort | continue] 

■ 

■ 

include 

Reads in and processes a command file, 
include "filename” 

■ 

■ 

show 

Displays the macro source. 

show macro_name () [, window_nuinber] 

■ 

■ 

vmacro 

Attaches a macro to a user-defined window, 
vmacro window_number [ ,macro_name{) ] 

■ 

■ 
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Symbol and expression commands 

These commands add, remove, and display S3nnbols and 
expressions. 


Command 

Description/Syntax 

MWX-ICE 

XHS 

add 

Creates a symbol. 

ADD [type] symbol_name [Scaddress] 
[=value [, value] . . . ] 

■ 

■ 

browse 

Displays class inheritance information. 

BROWSE symbol^name 

■ 

■ 

cexpression 

Calculates the value of an expression. 

C expression 

■ 

■ 

context 

Shows current context. 

CONT [/F] 

■ 

■ 

delete 

Deletes a symbol from the s 3 nnbol table. 

DEL { symbol__name | \\ | \ } [,y] 

■ 

■ 

expand 

Displays all local variables of a procedure. 

EXP [stack_level] [, window_number] 

■ 

■ 

printsymbols 

Displa 3 rs symbol, type, and address. 

PS [/C|/D|/E|/F|/M|/R|/T|/W] 

[nameE*]] [Xlwj*] 

■ 

■ 

printtype 

Displays high-level symbol information. 

PT syittbol__name 

■ 

■ 

printvalue 

Prints the value of a variable. 

P [/H 1 /S 1 /T] {expression \ 
expressi on^range } 

■ 

■ 

scope 

Specifies current module and procedure scope. 
SCOPE [/F 1 root_name\\ \ 

[ root__name\ \] module_name | 

[ [ root_name\\ ] module_name\ ] 
iprocedure^name \ {expression) | 
^stack^level | §line_nuinber)] 

■ 

■ 
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Simulating port I/O and interrupts 

These commands enable simulation of interrupts and of input 
and output to and from port. 


Command 

Description/Syntax 

MWX-ICE 

XHS 

din 

Displays input port buffer values. 

DIN [port_addr \ port_ad[dr_range] 

■ 

■ 

dout 

Displays output port buffer values. 

DO [port^address | 
port_addres strange] 

■ 

■ 

inport 

Sets or alters input port status. 

INP [/B 1 /W 1 /L] port_address 
[, lnput_source] 

■ 

■ 

outport 

Sets or alters output port status. 

OU [/B 1 /W 1 /L] port_address 
[ , output_destination] 

■ 

■ 

pause 

Pauses simulation for specified seconds. 

PA in] 

■ 

■ 

rin 

Rewinds input file associated with input port. 

RI port_address 

■ 

■ 

rout 

Rewinds output file associated with output port. 
ROU port__address 

■ 

■ 
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utility commands 

The utility commands perform miscellaneous operations. 


Command 

Descriptioni/Syntax 

MWX-ICE 

XHS 

alias 

Substitutes XRAY command name with 
another. 

AL [alias__name [= [definition]]] 

■ 

■ 

status 

Shows the status of the debugger or target. 
STAT [ALL 1 XRAY | HELP | SEARCH] 

■ 

■ 

xlate 

Converts logical address to physical address. 
XLATE address 

■ 
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Connection and configuration commands 

These commands provide an alternative way of defining and 
saving emulator connections and configurations. 


Command 

Description^yntax 

MWX-ICE XHS 

conclear 

Clears all defined connections. 

CONC 

■ 

condelete 

Deletes a defined connection. 

COND symbollc_name 

■ 

confiLg 

Configures a connection. 

CONF [symboli c_name , ETHERNET, 
hostname] 

■ 

conlist 

Lists all defined connections. 

CONL 

■ 

connect 

Connects to the specified emulator connection. 
CONN [/FO] symbolic^name 

■ 

consave 

Saves the emulator connection and 
configuration. 

CONS C/A 1 /O] {filename] 

■ 

disconnect 

Disconnects fi'om the emulator. 

DISC 

■ 
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XRAY commands not supported in MWX-ICE 

The following commands are not supported in MWX-ICE. 

Command 

analyze 

find 

history 

host 

ice 

interrupt 

next 

noice 

nointerrupt 
nomemaccess 
printanalysis 
printprofile 
profile 
ramaccess 
romaccess 
setstatus event 
setstatus qualify 
setstatus read 
setstatus trace 
setstatus trigger 
setstatus verify 
setstatus write 
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Command 


startup 
status buffer 
status event 
status qualify 
status trace 
status trigger 
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Chapter 10 

MWX-ICE Tutorial 


This chapter introduces you to the MWX-ICE debugger 
interface, demonstrates the use of many commands commonly 
used in a debug session, and provides practical examples for 
using the emulator in common debugging situations. 

The last part of the tutorial covers the basics needed to prepare 
code for an embedded system apphcation. 

It is assumed that you have already set up the emulator 
{Emulator Installation Guide), instiled the MWX-ICE 
software, and set up your environment (Chapter 2 of this 
manual). 



Contents 

Page 

How to use this tutorial 

10-2 

MWX-ICE debugger 

10-3 

Debugger basics 

10-5 

Typical debugging operations 

10-12 

Using the SuperTAP — practical examples 

10-57 

Before starting the tutorial, make sure that MWX-ICE is 
properly installed, with all its default settings, in the 
installation directory on yo\ir local hard disk. 
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How to use this tutorial 


Tutorial program 

The program CDEMON.ELF is used throughout the tutorial. 
This file was built on a Sun host, but it can be used without 
problems by the MWX-ICE debugger for Windows. 

User-entered commands 

Throughout the tutorial, an arrow in the margin indicates a 
procedure that you need to follow. For example, the following 
procedure asks you to enter the context command. Note that 
when you are asked to enter a command, you need to switch to 
(activate) to the Command window. 

> Example of a command for you to enter 

■ In the Enter Command box, enter: 
context 

MWX-ICE allows most commands to be abbreviated. The 
abbreviated command is used whenever possible. 

> An example of the abbreviated form of the 
"context (cont)^’ command 

■ In the Enter Command box, enter: 
cont 

Many of the commands used in the tutorial can also be 
executed by activating debugger command buttons, menus, 
and notebooks. These alternate methods will be noted in 
brackets following the command line syntax. 

All the MWX-ICE commands used in the tutorial are covered in 
depth in Help. A command quick reference is included in 
Chapter 9 of this manual. 


10-2 


MWX-ICE User^s Manual (Windows) 


MWX-ICE debugger 


General description 

The MWX-ICE debugger has a windowed user interface. 
Commands can be entered in a variety of ways: by typing the 
command in a Command window, by cUcking a button that 
activates the command, by choosing a command from the menu 
bar, or by choosing a command from the shortcut menus that 
appear in specific windows. You can also use the MWX-ICE 
notebooks. The notebooks provide a convenient way of entering 
commands: choose the notebook page for the task you want to 
accomplish, and fill in the blanks. 

Users may find the more intuitive buttons easier to use while 
learning the debugger. If a button has a command line 
associated with it, that line will be printed in the Command 
window when the button is cHcked. This shortens the learning 
curve for users who may ultimately prefer the speed of the 
command line by providing learning reinforcement with each 
button click. 

Information about navigating the user interface can be found 
in Help. 

What you need to run the tutorial 

Before you can run this tutorial, you need to follow the 
procedures in Chapter 2. You need to define an emulator 
coimection, connect to it, and then save your configuration. 
Also, the first time you connect to the emulator be sure to select 
the Force OS Download option (Connections window). This 
ensures the emulator control software is correct for the version 
of tile debugger you are using. 

Environment variables 

If your software was installed in any directory other than 
C:\ST8XX, make sure the XRAYMASTER environment 
variable has been set up before you begin this tutorial. To check 
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the path and the environment variables you can type set from 
the DOS prompt. If XRAYMASTER has not been set up or you 
are not sure it is correct, please refer to Chapter 2 and set it 
now. 


starting the debugger 

> To start MWX-ICE 

■ See Chapter 2 for startup procedures. 



Rgure 10-1 MWX-ICE successfully connected to the SuperTAP emulator 
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Debugger basics 


The following sections demonstrate how to: 

□ Navigate the user interface. 

□ Execute commands. 

□ Shift between Run mode and Pause mode. 

□ Exit the debugger. 


General description 

The MWX-ICE debugger has a windowed user interface. 
Commands can be entered in a variety of ways: by tjrping the 
command in a Command window, by clicking a button that 
activates the command, by choosing a command from the menu 
bar, or by choosing a command from the shortcut menus that 
appear in specific windows. Also available for command 
execution and data entry are interactive debugger Windows 
and Notebooks accessed through pull-down menus. 

Users may find the more intuitive buttons easier to use while 
learning the debugger. If a button has a command line 
associated with it, that fine will be printed in the Command 
window when the button is clicked. This shortens the learning 
curve for users who may ultimately prefer the speed of the 
command line by providing learning reinforcement with each 
button click. 

Information about navigating the user interface can be found 
in Help. 

Navigating the user interface 

The MWX-ICE debugger has a multi-windowed graphical user 
interface (GUI). The main window can display several other 
windows at once — such as Command, Code, or Registers — 
but only one window at a time can be active. 
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Using the mouse 

Left mouse button^—Activates windows, selects text (point and 
drag), and invokes commands and global menus. Select items 
such as file names and directories by double-clicking them. 

Right mouse button—^Activates pop-up menus for the current 
wdndow. 

Selecting windows 

A window becomes active when you move the mouse cursor into 
it and left click once. After that, any time the cursor enters the 
window it wdll become active and a region of the window that 
accepts keyboard input will be highhghted. 

Resizing windows 

You can resize a window by moving the mouse to a comer of the 
window, then dragging the comer until the window is the 
desired size. 

To make a window full-size, click the Maximize button in the 
upper-right comer, or click the Control menu button and 
choose Maximize. 

Scrolling windows 

You can scroll up and down in an active window by left-clicking 
the scroll bar’s up or dovm arrows or by chcking the scroll bar’s 
slider then dragging it to the desired position. 


If you are new to Microsoft Windows 95, please run Microsoft’s 
excellent tutorial on using Windows standard time-saving 
features before you continue this chapter. It takes only a few 
minutes, and it will make you productive much faster. In the 
Program Manager menu bar, cHck Help and then click 
Windows Tutorial. 
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Window terms and objects 


Go button 


Menus 

Menus are lists of conunands or other items you can choose. 
Menus are displayed by clidking on the menu name with the 
left mouse button. Pull-down menus always display tiie menu 
name. Option menus display the current selection. 

Buttons 

A command button is a small box with a word or graphic inside 
of it on a window. Clicking on the button performs a command. 

Text fields 

A text field is a long, rectangular box in which you can type 
text. To enter text in a field, click the left mouse button inside 
the field. A black border should surround the field, and a cursor 
should appear inside of it. If a cursor does not appear, then this 
field is not an input field. 

icons 

An icon is a graphical representation of minimized element. 
Clicking on an icon displays the element. 

Dialogs 

A dialog is a screen that displays options for you to select. It 
contains command buttons that let you perform actions as well. 
A dialog usually opens as a result of a command, performs one 
specific ftmction, and closes. For example, the box that appears 
when you select Open from the File menu is a dialog. 

Dialogs such as the one that appears when you select Open 
from file File menu require an action before you can return to 
the window. Dialogs such as the File Chooser (described in the 
following section) may remain open while you perform a 
different task in the window. 


Shortcut menus 

Context-sensitive shortcut meniis appear at the position of the 
pointer when you right-click the client area of certain windows. 
The commands available on a shortcut menu are duplicates of 
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tlie commands on menu bar menus. Which ones appear 
depends on where the pointer is when you right-cUck. The 
exercises in this tutorial point you to frequently used shortcut 
menus. 

Notebooks 

Notebooks are sets of options grouped into “pages.” The pages 
contain options that you can select from; some options require 
only a cUck on or off and others require that you enter a file 
name, a symbol name, or value. Each page in a notebook acts 
separately and must be “applied” for the selections made on 
that p£^e. The pages retain yom modifications as you browse 
through the notebook, but the options are not added to the 
project or tool until you click apply for each page. 


Note 



Notebooks are really separate programs. Therefore, if you 
have a notebook open and then you click an3nvhere in the 
debugger client area, the notebook seems to disappear. When it 
does, it is actually still open and running behind the debugger 
main window. To display the notebook again, press ALT-TAB. 



File Chooser button 


File/Directory Chooser 

The File Chooser button appears whenever you need to enter a 
file name or directory. To open the File Chooser, cli(h the File 
Chooser button and select an option from the menu that 
appears. Previous choices given for the file name or directory 
appear at the bottom of this menu in addition to the File 
Chooser option. 


Executing debugger commands 

Debugger commands can be entered in a variety of ways. You 
can: 


□ Click a toolbar button that activates the command. 

□ Choose a command from a menu on the menu bar. 

□ Enter commands and options in a notebook. 
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a Choose a command from one of the shortcut menus that 
appear in specific windows. 

□ Type the command in the info bar Enter Command box (but 
only when the Command window is active). 

The contents of menu bar menus, shortcut menus, and the info 
bar are context sensitive; they change, depending on which 
window is active. For example, the Enter Command edit box is 
visible only when the Command window is active. 

Some users naturally gravitate to the menus in the beginning. 
To use the menus to enter a command, chck the menu you want 
and then click the command you want. 

You m^ht also find the buttons on the tool bar easy to use 
while learning the debui®er. Notice that, if a button has a 
command line associated with it, that line is printed in 
Command window when the button is clicked. Although using 
the tool bar can shorten your learning curve, you might later 
prefer the speed of the Enter Command box. If you have noted 
the commands associate with the buttons, you will be better 
prepared to use the command entry box. 

V To enter a command through a notebook 

1. From the Notebooks menu, choose the notebook for the task 
you want to accomplish. 

2. Chck a tab on the notebook to select a page. 

3. Fill in the blanks and select the options you want. 

4. Chck the command button for that page. 

> To enter a command from a shortcut menu 

1. Chck the cursor in a window, a dialog box, or on a field. 

2. Chck the alternate (usually the right) mouse button. 

A smaU menu pops up, displaying commands that relate to 
the object you are working with in the window. 
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Most of the exercises in this tutorial suggest you enter 
conunands through the Enter Command box. Look for the 
Enter Command box in the info box, just below the tool bar in 
the MWX-ICE window. The Command window needs to be 
active for the Enter Command box to be displayed. 

>- To execute a command using the Enter Command box 

1. With the insertion point in the box, type the command. 

— or — 

Click the button to the right of the box. A dropdown list of 
most recently used commands appears. Select the command 
you want. 

2. Press Enter. 

— or — 

Click the Enter Command button, to the left of the entry box. 

Working in pause mode or run mode 

The SuperTAP emulator operates in one of two modes: nm 
mode, when the emulator is executing target code, and pause 
mode, when the emulator is not executing target code. In run 
mode the cursor turns into an animated icon—a “running 
man.” 


l;^l 

>- To start run mode 

■ On the toolbar, click Go. 

I ' i 

Go button 

—or— 

[&i 

■ In the Enter Command box, type: 
go 

>- To return to pause mode 

■ On the toolbar, click Stop. 

Stop button 
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Exiting the debugger 


You can exit the debugger at any time. There are two ways to 
exit MWX-ICE: 

□ From the Command window, type q y in the Enter 
Command box. 

—or— 

□ From the File menu, choose Exit Debugger. 

Getting debugger Help 

MWX-ICE Help feature is a context-sensitive, h 3 ^ertext linked 
compilation of procedures, reference, and practical tips. It can 
be started from any debugger window. 

Leave Help nmning while you go through the demonstration. 
You can minimize the application to conserve screen space and 
restore it when needed. 

> To start MWX-ICE Help 

■ From the menu bar, choose Help. 
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Typical debugging operations 


About the demonstration code 

Cdemon is the Applied Microsystems standard C-language 
demonstration program, providing examples of many code and 
data constructions used by C programmers. Cdemon is 
composed of four major functions running in main(): initialO, 
stepO, dataO, and run(). An Inspector window can be used to 
see the output of some of the functions. 

The demonstration program is designed to be used without a 
target. The SuperTAP emulator runs in isolation mode, and the 
program uses the emulator’s overlay memory. The Cdemon 
include file described below maps overlay memory for you, and 
the emulator automatically enters isolation mode when it is not 
connected to a target. 

For a detailed explanation of the Cdemon demonstration 
program, see Appendix C of this manual. 

Loading the demonstration code 

An include file is simply a file containing debugger commands 
that will be executed when the file is loaded by the debugger. 
The supplied include file, CDEMON.INC, maps overlay then 
loads the Cdemon absolute file from the DEMO subdirectory. 

> Load the demonstration file 

1. From the File menu, choose Change Directory. 

2. Select the installation demo directory (C:\ST8XX\DEMO) 
and click OK 

3. From the File menu, choose Include Commands. 

4. Select CDEMON.INC, and choose OK 

Observe the Command window for SuperTAP status and ex¬ 
ecuted commands. As MWX-ICE reads the include file, the 
commands are executed. The overlay memory map is dis¬ 
played in the View Window. The Cdemon program is down- 
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loaded to the emulator’s overlay memory. After the file is 
downloaded, the Code window displays the source module, 
shown in Figure 10-2. Once the code is downloaded, you can 
go ahead and close the View window. 



Figure 10-2 Cdemon demonstration file successfully loaded 


Viewing source-ievel and assembly code simultaneously 

You can choose the Copy This Window command from the 
Displays menu to open multiple instances of a window. In the 
following example, you open two code windows: one window 
displaying source-level and the other displajdng assembly. The 
two windows will stay synchronized during all emulator 
operations such as single-stepping, running to breakpoints, 
and restarting the code. 
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> Open another Code window and display assembly 
1. Switch to the Code window. 

1. From the Displays menu, choose Copy This Window. 

2. In Mode box of the new Code window, choose Assembly. 
You can arrange the two Code windows for the best viewing, 
shown side-by-side in Figure 10-3. 


: MWX ICE Debugger 


Fie £d» displays Notebooks View Vmdow Molp 


m^m 


• Sourcs O JLsssably 


; MWXST8G0[fra22le] - Code 




KPC860 Module: ClXMOIf File: odeAon.ec 


^Code 


MPC860 Module: CSEMOH 


File: edemon.:^ 


**^^*^,^,^r■^■k^,^,*■^,^,^,^t****■^r^t*****■^t****^H,***^t■^^**^^******^,^t*‘& 


int 

main tint, cbor 


if ( %diieh._demo ) 

eleyjMsinO ’ 


/* ProjnMdft Stairbs 


initial n f 

/* 

sfcspO? 

/* 

dataO? 

/* 

run ()} 

/* 

return 0; 



* Initiodize Variables */ 


** Initialize Static Variables 

***iHH,*'i,********************'tt*4r******'ir*************^ 


static void initial (void) 


( 


I— n I iTiTii 


Oddis 

HKSEKXSSfi 

ff£02008: 

382b£££0 

oddi 

rl,rll/0x£i 

ff£0200e: 

3da08001 

Oddis 

rl3,0,0x££l 

£££02010: 

39ad8334 

oddi 

rl3.rl3,0x; 

£££02014: 

3e40£££l 

oddis 

r2,0,0x£££i 

£££02018: 

3842£d90 

oddi 

r2,r2,0x££i 

£££0201c: 

38000000 


rO,0,0x0 ! 

£££02020: 

9401££c0 

stwu 

rO,-0x0040! 

£££02024: 

38000042 

oddi 

rO,0,0x42 : 

£££02028: 

7c000124 

mtnsr 

rO 

£££0202c: 

3d200220 

oddis 

r9,0,0x220r 

£££02030: 

61290000 

ori 

r9,r9,0x0 S 

£££02034: 

7d3e9ba6 

ntspr 

iMkr,r9 I 

£££02038: 

3c80££££ 

oddis 

r4,0,0x£££| 

£££0203c; 

6084££00 

ori 

r4,r4,0x££| 

£££02040: 

90890004 

stw 

r4,0x0004{ 

£££02044: 

3e80£££0 

oddis 

r4,0,0x£££ 

£££02048: 

38840001 

oddi 

r4,r4,0xl 

£££0204c: 

90890100 

stw 

r4,0x0100{ 

£££02050: 

3c80£££0 

oddis 

r4,0,0xf££ 

£££02054: 

60840170 

ori 

r4,r4,0xl7 

£££02058: 

90890104 

stw 

r4,0x0104( 


|^MWXST860[frazzle] - 


TjOading section '.sbss‘ located at 0x80000374.. Ox800003CI 
Lo<id-ing section '.bss* located at 0x8O0003C8.. 0x80000SI>8 


nnBirxi j 


El 


•‘ig aa T Tx r 


Figure 10-3 Displaying source-level and assembly code 
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Displaying configuration information 

If you ever need to call Customer Support for assistance, the 
information displayed in the Command window during startup 
and the data returned by two debugger commands can help 
them resolve your call. 

If you cannot get past startup, record any messages that 
appear in the Command window. 

> To display operating environment information 

1. In the Enter Command box of the Command window, enter: 
stat all 

The View window lists details about the current operating 
environment, as shown in Figure 10-4. If you have the View 
window minimized as an icon, youll need to double-click it. 

2. When you are done, close the View window (CTRL + F4). 
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Figure 10-4 
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> To display emulator and debugger configuration 
information 

■ In the Enter Command box of the Command window, enter: 
hwconfig 

This hsts emulator component, firmware, and software revi¬ 
sion levels and installed options in the Command window. 

Modifying and saving debugger startup options and windows 

You can change your MWX-ICE and emulator configuration 
options and then save them to the startup include file 
(STARTUP.INC). MWX-ICE uses the startup include file as 
the default configuration each time you start the debugger. 

STARTUP.INC contains definitions of valid devices, a 
connection command, and an include-file set of configuration 
commands derived from the emulator configuration windows. 
You can have several, uniquely named startup files to 
configure the debugger for specific situations. 

Configuration dialogs are provided for 

□ Defining emulator connections 

□ Execution control 

□ Trace system 

□ Memory configuration 

□ Event system setup 

□ File handling 

□ MWX-ICE interface options 
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Rgure 10-5 Emulator Configuration window 

Displaying current configuration 

>■ To display the current MWX-ICE settings 

■ Open all the configuration windows. 

—or— 

■ Execute emuvars, memvars, xicevars, evtvars, and 
options from the Command window. 

Saving the current configuration 

>- To save the current debugger options 

■ In the Enter Command box, enter 
consave 

—or— 

■ From the File menu of the Emulator Configuration window, 
dioose Save to File. 

This saves the emulator’s current configuration either to 
STARTUP.INC or to the file name that you specify. 

For detailed descriptions of all the configuration options, see 
Help. 
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Saving window position and fonts 

>■ To save the startup position of any MWX-ICE window 

■ Use the Save Configuration command firom the File menu. 

The Save Configuration command saves the window position to 
a file called MASTER.INI. You can edit this file by using any 
text editor. 

To modify window color, fonts, or mouse configuration, use the 
Windows Control panel. 

Recording and replaying a debug session 

Sometimes it may be useful to record the commands used 
during a debug session. 

Recording commands 

Sometimes it may be useful to record the commands used 
during a debug session. The log command (the Log page in the 
Debugger Files notebook) opens a file and saves the command 
line input into the named file. 

> To record commands and save them to a file 

■ In the Enter Command box, enter: 
log on=filename.log 

where FILENAME.LOG is the name of the file you want to 
create. 

> To stop recording 

■ In the Enter Command box, enter: 
log off 

The debugger stops recording and closes the log file. 

Replaying commands 

You can use the log file as an include file, which the debugger 
loads and executes to recreate a previous debugging session. 
You can load and execute a log file several ways: 
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>- To use the command line 

■ In the Enter Command box, type: 

Include filename.log 

>- To use the notebook 

1. In the Debugger File notebook, Include page. Filename box, 
type: 

filename.log 
—or— 

Click the File Chooser button and choose a file from the box. 

2. In the Specify Handhng Mode group box, select one of the 
three handling modes. 

3. Chck the Include button. 

Recording commands and their output 

The journal command [Journal page in Debugger Files 
notebook] records both the commands and their output into a 
file. This will be demonstrated later in the tutorial where we 
use the conunand to save the contents of the emulator's “bus 
cycle trace” memory. 


Convenience features 


Command history 

You can display a list of executed commands or recall a specific 
command from the hst by cUcking on the history icon located 
directly to the right of the Enter Command text box. 

Command aliasing 

The alias command [Ahas page in the Symbol Management 
notebook] lets you to assign a different name to a debugger 
command. Preferred abases can be placed in an “include^" file 
and loaded at the start of your debug session 


SuperTAPSXX 


10-19 




For example, the following command creates the ahas Id for 
the load command. 

alias load=ld 

Getting oriented with the code 

When starting a debug session you will want to get oriented 
with the code, particularly if the code is not your own. The 
following commands will help you do this. 

Displaying available modules 

A quick display of the names of the source modules available 
for debugging is a good place to start. The printS3mibols [Info 
page in the S 3 nnbol Management notebookl is an important 
and versatile command with many options for displaying 
symbols and subsets of symbols. Use the printS3mibols (ps) 
command with the /m flag and * argument to display all 
module names. Of course with very large programs containing 
many modules, this may be impractical. 

The command will display the names of Cdemon’s modules 
along with “type’^ and address information for each module. 
You can resize the Command window so all the options are 
viewable. 

> To display module names 

■ In the Enter Command box, enter: 
ps /m * 

Current viewing (scope) and execution context 

The debugger is capable of viewing a module that is not the 
current execution module. The current execution module is the 
module that the program coimter (PC) is focused on. If you 
were to execute a step command the debugger would execute 
the source line pointed to by the PC. Use the context (cont) 
command to display the current “viewing” and “execution” 
modules. 
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>- To display context (current viewing and execution 
modules) 

■ In the Enter Command box, enter: 
cont 

Note the current viewing module line, CDEMON, will have 
“(view)” at the end of it, while the current execution module 
line, AUB, will end in “(PC)”. 

Changing scope 

The viewing context can be changed by using the scope (sc) 
command [Scope button in die Code window]. This will cause 
the source for the module to be displayed in the Code window. 
It also allows access to the module’s symbols and line numbers 
without having to type the qualifying module or procedure 
name, saving a considerable amount of typing. 

The scope command is case sensitive. 

> To change the current scope to the module DATA 

■ In the Enter Command box, enter: 

sc DATA 

> To display the current context 

■ In the Enter Command box, enter: 
cont 

Notice the current viewing module is now DATA, while ALIB 
remains the current execution module address. 

> To return to scoping the current execution module 
CDEMON 

■ In the Enter Command box, enter: 

sc 
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other C source operations 

There are otiier debugger commands that display source 
without changing scope: 


Source code operation Command 


Display source without list [List page in the Debugger 
changing scope. Files notebook] 


Evaluate expressions. cexpression 


Display parameters expand [Stack page in the 
passed to procedures. Memory Command notebook] 


These commands are covered in Help. 


Checking the state of the debugger and emulator 

When starting a debug session you should take a quick look at 
the state of the debugger and emulator. This is particularly 
true if someone else has used the emulator between your 
sessions. Also, you should examine the state of the debugger 
and emulator any time you get unexpected results from 
breakpoints or event system setups. 

The following commands will allow you to view and modify the 
parameters that control the state of the debugger and 
emulator. 
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> To view the emulator configuration 

■ From the Displays menu, choose Emulator Configuration. 
The Emulator Configuration window appears. 


V Emulator Config 




Cozmections 


Tract 


Elxecution 


Utmory Rtod/Writc 


Hemory 


Event 


File Handlizzof 


Debugger Options 



Figure 10-6 Emulator Configuration window 


You can use the Emulator Configuration window to view and 
modify the options that control the state of the debugger and 
emulator: 

Connections The Connections button brings up the 
Connections window. Use this window to define and connect to 
emulators. 

Event The Event button opens the Event configuration 
dialog box. Use this dialog box to set the emulator event system 
options. 

Execution The Execution button opens the Execution 
configuration dialog box. Use this dialog box to set the 
emulator execution options. 

File Handling The File Handling button opens the File 
Handling dialog box. Use this dialog box to specify the upload 
and download format for non-IEEE-695 object files, and to 
other download options. 
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Memory ReadA^rite The Memory Read/Write button opens 
the Memory ReadAVrite dialog box. Use this dialog box to 
enable overlay memory, and to conrol access to overlay by 
external bus masters (Isolation of overlay read/write). 

Memory The Memory button opens the Memory 
configuration dialog box. Use this dialog box to set memory 
access attributes. 

Trace The Trace button opens the Trace configuration dialog 
box. Use this dialog box to set emulator trace collection and 
display options. 

Debugger Options The Debugger Options button opens the 
Debugger configuration dialog box. Use this dialog box to set 
input and output radix and otiber debugger options 

Controlling the processor and the emulator 

Changing the contents of a CPU register 

While debugging yom code, you may find a register holding a 
different value than what you expected. The Register window 
allows you to directly modify the contents of a CPU register. 
This lets you replace the questionable value with the expected 
value and test the results. 

> To chaise the contents of a CPU register 

1. From the Displajrs menu, choose Register. 

2. From the Register menu, choose (Jeneral registers. 

The General registers window appears. 

3. Chck the IP (instruction pointer) button. 

The Prompt Dialog box appears and shows the current value 
of the counter. 

4. Delete the current value; type 0x100 in the dialog box, and 
choose Set. 

Note the IP register value displayed in the Register window 
has changed to 00000100. 
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5. Now, set the contents of the IP back to 0xftfD2004. 


Note 


You can also use the setreg command in the Command 
window to chaise the contents of registers. For example, you 
could use the commands: setreg @ipsOxl00 and setreg 
@ipa()xffR)2004 to change the contents of the IP to 0x100 and 
back again. 


Other emulator controls 

There are commands that control the handling of bus time-outs 
Cbte), show cycles (showcycle), timestamp resolution 
(timclk), and real-time emulation (rte). For more information 
about these controls, see Help for the Emulator Configuration 
window. These commands are also described in Help. 


Memory control 


Displaying memory addresses and variables 

The dump (du) command [Memory window] displays the 
contents of memory at a given address or range of addresses in 
both hexadecimal and ASCII format. 

As do most MWX-ICE commands, dump also accepts a symbol 
name as an address argument. This allows us to dump the 
contents of the tutorial’s memory mapped output port, led_port, 
without recalling the port’s numerical address. (Note: you can 
also find the address of ledjort with the printssmibols 
command.) 

> To dump the contents of led_port 

■ In the Enter Command box, enter: 
du &led_^ort 

Another way of viewing the contents of led__port is to use the 
printvalue (p) command [Print button in the Code and 
Command windows]. The printvalue (p) command displays 
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the values of expressions according to their type. The 
printsymbols (ps) command will show led_port is an array of 
signed char, so printvalue will display character values found 
at led^port. 

> To display ssntnbol information about led_port 

■ In the Enter Command box, enter: 
ps led_port 

> To print the value at led_port 

■ In the Enter Command box, enter: 

p led__port 

You may want to keep a continuous display of a variable’s value 
on the screen. The monitor (mon) command creates a Data 
window and displays the selected variable. The display is 
updated during every run-to-pause transition. 

> Monitor the variable led^port 

■ In the Enter Command box, enter: 
mon led__port 

Modifying memory 

Modify memory with the setmem command [Memory window]. 
Setmem has a switch for byte, word, and longword data 
arguments. We will use setmem with the longword switch. A, 
to modify the contents of ledj)ort, and then view led_port with 
the dump and printvalue commands. 

> Set memory at led_port, then di^lay the new contents 

■ In the Enter Command box, enter: 

setmem/l &led__port='‘MWX-ICE'' 
du/1 &led_port 
p led_port 
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Using the single line assembler 

There may be times when you need to make a small change to 
an assembly module, perhaps just to try something out. Use the 
debugger’s built in line assembler to make your patch and 
avoid a time consuming “exit debugger, edit code, assemble and 
link, download, and try-it-out” debugging cycle. The line 
assembler is invoked with the asm command. 

> To assemble a "nop” loop beginning at address 
0x80000100 

■ In the Enter Command box, enter the followup commands: 

asm org 0x80000100 
asm nop 
asm nop 

asm b 0x80000100 


Using the memory disassembler 

Disassemble the “nop” loop at 0x80000100. The disassembled 
memory is displayed in the assembly mode Code window. 

> To disassemble memory at 0x80000100 

1. In the Enter Command box, enter: 

disa 0x80000100 

2. Switch to the Code window and select the Assembly Mode 
option. 

You should see code similar to the following: 

80000100: 60000000 ori r0,r0,0x0 

80000104: 60000000 ori r0,r0,0x0 

80000108: 4bfffff8 b .-0x8 

3. When you are done, select Source mode to return to the 
source code view. 
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other memory operations 

There are other memory operations that you can perform.: 


Description 

Command 

Line 

Memory 

Commands 

Notebook 

Fill memory with a given 
value 

fill 

Fill page 

Copy the contents of one block 
of memory to another 

copy 

Copy page 

Compare the contents of two 
memory blocks 

compare 

Comp page 

Search through memory 
for a pattern 

search 

Search page 


These commands are covered in Help. 


Using overlay memory 

Overlay memory is emulator memory that can replace target 
memory by overlaying it, or be used where target memory 
resources do not esdst. Assigning overlay memory to address 
rar^es and access types chosen by the user is called mapping 
overlay. The memory map can be permanently stored in an 
MWX-ICE include file. 


Note 



Overlay has a minimum granularity of 128K If a mapping does 
not begin and end on a 128K boimdary, the emulator 
automatically adjusts the mapping in both directions to the 
next 128K boundary and issues a warning that it has adjusted 
the original mapping. 
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Displaying the memory map 

Use the map command without arguments to display the 
current overlay vs. target memory map. 

>- To display current overlay vs. taigfet memory map 

1. Switch to the Command window. 

2. In the Enter Command box, enter; 
map 

In the View window, you should see a display of the type of 
memory (RW, RO, or WO), its address range, and how much 
emulator overlay memory remains. The types of memory are 
read-only (RO), write-only (WO), or read-write (WR). 

3. Close the View wiudow (CTRL + F4). 

Mapping overlay memory as RAM 

You use the map command with a range argument to map 
overlay memory as read/wiite memory (RAM). Memory 
mapped as RAM is fully accessible to die executing program 
and to the user. 

For example, the following commands map overlay from 
0x1000 to 0x2000 as RAM: 

map 0x1000..0x2000 

Mapping overlay memory as ROM 

You use the map command with a range argument followed by 
=ro to map overlay memory as read only memory (ROM). 

If the executing program writes to memory mapped as ROM, 
the writes are blocked by the emulator. However, you can still 
write to this memory using any debugger memory write 
command such as setmem or fill. 

For example, the following commands map overlay from 0 to 
Oxfff as ROM: 

map 0x0..Oxfff=ro 
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Mapping overlay memory as write only 

You use the map command with a range argument followed by 
=wo to map overlay memory as write only memory. 

If the executing program reads memory mapped as write only, 
the reads are blocked by the emulator. However, the user can 
still read this memory using any debugger memory read 
command such as dump or disassemble. 

For example, the following commands map overlay from 0 to 
Oxfff as write only: 

map 0x0..Oxfff=wo 

Mapping overlay memory back to target memory 

If you have target memory, you can use the map command 
with the starget argument to reassign memory to the target. 

For example, the following commands return overlay memory 
from 0x1000 to 0x2000 to target: 

map 0x1000..0xlfff=targGt 

Copying target memory contents to overlay memory 

Use the following procedure when you need to copy the 
contents of your target ROM or PROM into overlay memory for 
patching, to avoid having to bum a new ROM. 

Map overlay memory over the range of the ROM. Next, set up 
the overlay access types: copyfrom off (use target as the 
source) and copyto on (use overlay as the destination). Set 
ovwritethru off to block any write operation directed at the 
ROM to avoid contention on the address bus. Use the copy 
command to copy the contents of target memory into overlay 
memory starting at the same address as the target ROM’s first 
address. 

For example, the following commands copy the contents of 
target memory into overlay: 

map 0x9000..0x9fff 
overlay copyfrom off 
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overlay copyto on 

ovwritethru off 

copy 0x9000..0x9fff,0x9000 

Note that unless you have target memory in the address range 
this example uses (0x9000..0x9fH), the copy command will 
cause a machine check exception. 


Basic breakpoints 

When debugging code, the abihty to stop code execution at any 
desired place is absolutely necessary. To provide this ability 
SuperTAP supports four types of breakpoints: 

□ Asynchronous breakpoint 

□ External breakpoints 

□ Software instruction-execution breakpoints 

□ Hardware-implemented access breakpoints 

When breakpoint conditions are met, SuperTAP can perform 
any of the following actions: 

□ Stop emulation (break). 

□ Execute a C expression. 

□ Log the value of an expression in a file. 

□ Execute a debugger macro. 


Asynchronous breakpoint capabiHty lets you stop code 
execution at any time cHcking any of the MWX-ICE Stop 
buttons. 


External breakpoints allow an external trigger-in signal from 
the target or from a piece of test equipment, such as a logic 
analyzer, to cause the SuperTAP to ‘Tbreak” out of emulation. 
Or, the SuperTAP can generate a trigger-out signal to trigger a 
logic analyzer or storage scope. SuperTAP provides one BNC 
trigger input and one BNC trigger output pin to support both 
types of external breakpoints. 
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Setting and clearing instruction breakpoints 

Software breakpoints replace the instructions in the target 
program with a special opcode that forces a specific behavior in 
the microprocessor. When the breakpoint occurs, SuperTAP 
halts execution and places the original instruction back into 
memory. 

Software breakpoints must be located in RAM, so that the 
special opcode may be written to taigret memory.This poses no 
problem, since SuperTAP overlay memory can easily be used 
for setting breakpoints where no target RAM exists. 

MWX-ICE offers a variety of methods to set and clear 
breakpoints. Below, you sample the various methods including: 

□ Using the Execution Control notebook 

□ Choosing the BreakI button witfi a source line selected 
a Using the shortcut menu in the Code window 

□ Using the Breakpoints window 


> To set a breakpoint using a notebook 

1. From the File menu, choose Restart. 

This restarts the Cdemon program. 

2. From the Notebooks menu, choose Execution Control. 

3. From the Execution Control menu, choose Set and clear 
breakpoints. 

4. In the Start Address box, enter: 

main 

5. Choose the Set Break button, to set the breakpoint. 

Notice that “Breaklnstruction main” is echoed in the Com¬ 
mand window. By observing and remembering the com¬ 
mands generated while using notebooks and buttons, you 
can qiiickly start using the command line interface. 

6. In the tool bar, choose the Go button ^ I to run to the 

breakpomt. ■■■■■•hm 
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Notice that the Code window box indicating the current exe¬ 
cution line has moved to the beginning of mainO. Also notice 
the breakpoint icon (a small stop sign) in the left side of the 
current execution line, shown in Figure 10-7. 

7. In the Execution Control notebook, choose Close, to close the 
window (ALT + F4). 



Figure 10-7 Breakpoint at beginning of main() 
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> To set a breakpoint using the BreakI button 

1. In the Code window, select the source line containing the 
stepO function by double-chcking anywhere in that line. 

When selected, there will be at least one character of the line 
highlighted. _ 

2. To set the breakpoint, choose the BreakI button J I from 

the tool bar. . 

Notice the breakpoint icon now displayed left of the stepO 
source line. 


3. Choose the Go button I to run to the breakpoint. 


> To set a breakpoint using the shortcut menu 

1. In the Code window, cUck the to the left of the line number 
for the run() function using the right mouse button. 

The shortcut menu appears. Shortcut menus contain com¬ 
mands related to the window and to the current context. 

2. Choose Set Break [double chck] from the shortcut menu. 

Notice the breakpoint icon now displayed left of the run() 
source line. You can also set a breakpoint by double-chcking 
to the left of the line number. 

3. Choose Go, to run to the breakpoint. 


You can also choose Set Break... from the shortcut menu to 
open the Define a Breakpoint dialog box. 
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Rgure 10-8 Setting a breakpoint using the shortcut menu 


> View the breakpoints 

■ From the Displays menu, choose Breakpoints. 


■ Select Break Info from the shortcut menu. To open the 
shortcut menu, use the right mouse button and click to the 
left of the line numbers in the Code window. 

Notice the three breakpoints displayed in the window. The 
first one was set at mainO using the Execution Control note¬ 
book. The second one was set at stepO by choosing the 
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BreakI button with a line selected. The third was set at run() 
using the shortcut menu. The Breakpoints window is shown 

in Figure 10-9. 
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Rgure 10-9 Displaying information about a breakpoint 


>- Clear the breakpoints 


1. In the Breakpoints window, select the top line by double¬ 
clicking in that line. 


2 . 


Choose the Clear button 



from the tool bar. 


3. Repeat steps 1 and 2 until the remaining breakpoints are 
cleared. 
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other ways of clearing breakpoints 

There are several ways you can clear breakpoints in addition to 
the way you cleared them from the Breakpoints window in the 
previous step. 


From the... 

Do the following... 

Breakpoints window 

Use the shortcut menu to clear breakpoints. Right-click on 
the breakpoint and choose Clear Break, or right-cHck in the 
Breakpoint window and choose Clear All. 

Select the breakpoint, and choose Clear Break from the View 
menu. 

Code window 

Select the source hnes where the breakpoints are set, then 
click the Clear button. 

Use the shortcut menu to clear breakpoints. To open the 
shortcut menu, right-chck to the left of the line number 
where the breakpoint is set. Choose Clear Break from the 
menu. 

Double-chck the right mouse button to the left of the line 
number where the breakpoint is set. 

Command window 

Use the clear command. 

Syntax: clear [n] 

n is the breakpoint number as it is shown in the Breakpoints 
window. To clear all breakpoints t3^e clear without a 
number. 


Setting temporary breakpoints 

Another kind of instruction breakpoint you can set is a 
temporary breakpoint. You can use temporary breakpoints 
when you want to run to a specific place in your code. These 
breakpoints do not appear in the Breakpoint window. You can 
set these breakpoints by selecting the source line you want to 
break on, and then clicking the GoUntil button in the 
tool bar. 
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You can also set temporary breakpoints by using the Execution 
Control notebook, or by using the shortcut menu in the Code 
window. 

Setting and clearing access breakpoints 

Hardware access breakpoints xise the SuperTAP's hardware 
and do not consume any target resources. When a memory 
access occurs that matches the breakpoint condition, 
microprocessor execution stops. Access breakpoints can be set 
over target RAM or ROM. 

Access breakpoints are set to break on an address with the 
following status options: 


Access 

Command 

Notebook 

Read access 

br 

Break page in Execution Control 
notebook 

Write access 

bw 

Break page in Execution Control 
notebook 

Read or write 

ba 

Break page in Execution Control 
notebook 


Access breakpoints are useful for detecting errant accesses to 
memory locations. For example, you may want to break 
emulation if your code writes to a read-only port address. 

Macros can be attached to access breakpoints. You may have 
multiple ba, br, and bw breakpoints set, each with its own 
macro attached. 

In the next example, you set a write access breakpoint (bw) at 
address OxAOOOOOO (the address of the LEDs. The pointer 
dot_port holds this address. Read access (br) andread-or-write 
access (ba) breakpoints are set similarly. 
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> To set a write access breakpoint 

1. Switch to the Command window. 

2. In the Enter Command box, enter: 
restart 

This positions the program counter at the start of the Cde- 
mon program. 

3. In the Enter Command box, enter: 
bw dot_port 

4. Choose Go j to run to the breakpoint. 

SuperTAP breaks emulation in the outledO function at the 
write to the memory-mapped address of the display dots. 
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> Clear the write access breakpoint 

1. Open the Breakpoints window. 

2. From the View menu, choose Show Break #. 

3. Switch to the Command window, and in the Enter Command 
box, enter: 

clear 1 

Note: Because this was the only breakpoint set, it was num¬ 
ber one. If it was the second of two breakpoints, you would 
use the command clear 2 instead, third use clear 3, and so 
on. Use clear without a number to clear all breakpoints at 
once. 

4. Close the Breakpoints window. 

Program execution and related commands 

The following commands control resetting the CPU, restoring 
the program start address, and executing the program in real¬ 
time or in steps at a time. 

Resetting the processor 

Use the reset (rese) command to restore the processor to its 
initial reset state. 

> To reset the CPU 

■ In the Enter Command box, enter: 
rese 

Restoring the program start address 

Use the restart (rest) command to reset the program coxmter 
to the program's starting address. For CDEMON.ELF this 
returns us to address OxfH02004. 

> To restore the program start address 

■ In the Enter Command box, enter: 
rest 
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starting and stopping program execution 

Use the go (g) command (or the Go button) to start or continue 
program execution. The program runs until a breakpoint is 
reached, an erro r occu rs, or the you stop emulation by chcking 
the Stop button I | from the tool bar. 

Use the go command with an address and a passcount to 
execute tmtil the address is seen "passcoimt” nximber of times. 
The command sets a temporary breakpoint at the address and 
counts each occurrence of the breakpoint. The cursor will turn 
into a nmning man indicator while the program executes. 

To execute until outledO is seen four times 

1. In the Enter Command box, enter: 
g outled%%4 

After the fourth occurrence of outledO, the emulator will 
break and display the current instruction address at the 
time execution stopped. 

2. Switch to the Code window and select Assembly Mode. 

After the fourth occurrence of outledO, the emulator will 
break and display the current instruction address at the 
time execution stopped. 

Stepping through the program 

Stepping refers to executing code a niunber of instructions or 
lines at a time. Single stepping executes either one assembly 
line or one source line of code at a time. To single step use the 
step (s) command (Stepinstr or StepLine button from the tool 
bar) without a number argument. 

For example, the following command executes five lines of code: 
s 5 

Use the stepover (so) command (StepOver or StepO Instr 
button in all windows) if you want to single step but do not 
want to step through called routines. This command will 
execute the entire called routine then stop. 
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Use the gostep (gos) conoinand if you want to step 
continuously until a specific condition is met. The condition is 
defined by a macro you attach to the gostep instruction. For 
instance, gostep can be used to step imtil a register holds a 
particular value. 

For example, the following command single-step until a 
condition defined in my_macro is met: 

gos iiiy_itiacro () 

Capturing and displaying execution trace history 

The trace capture feature lets the user observe exactly how the 
code executed. Raw trace consists of CPU bus level information 
including address, data, status, and timestamp information. 
Disassembled trace is displayed as assembly, source, or a 
mixture of both. Raw and disassembled trace are both 
displayed in the Command window. 

Clearing trace memory 

You may want to clear the trace memory bxzffer of previous 
trace information before running your code. This ensures all 
information in the trace buffer will be newly acquired. Use the 
trclr command to clear the trace memory buffer. 

> To clear the trace memory buffer 

■ In the Enter Command box, enter: 
trclr 

You can also clear trace memory from the Emulator Trace 
window. From the Displays menu, choose Emulator Trace. 
From the Actions menu, choose Clear Trace. 

Capturing trace in run mode 

Two emulator commands, trsys and trace, control the capture 
of program execution trace history. With trsys and trace on, 
every time you use go or step, the bus information generated 
is captured in the trace buffer. To find out if these variables are 
on or off, execute the emuvars command and observe their 
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status displayed in the list of emulator variables. If either 
variable is off, you turn it on by entering the appropriate 
command, trsys on or trace on. 

> To enable the trace capture system 

1. In the Enter Command box, enter: 
trsys on 

2. In the Enter Command box, enter: 
trace on 

The SuperTAP is designed to operate even when you are using 
the processor instruction and data caches. The SuperTAP trace 
system requires that the processor instruction show cycles are 
enabled. In most cases, you only need to generate show cycles 
for indirect branching. The MWX-ICE showinst command 
controls processor show cycles. 
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> To enable instruction show cycles 

■ In the Enter Command box, enter: 
showinst indirect 

Leave the show cycles enabled for the remainder of the tuto¬ 
rial. 

To collect trace information, you restart and then go to the 
Cdemon function houseO. 

> To restart, then go to houseO 

■ In the Enter Command box, enter: 
rest 

g DATAXhouse 


Displaying raw trace history in the Command window 

Use drt for displaying raw bus cycle information and optional 
logic state and timestamp information. 

> To display the captured raw trace information 

■ Maximize the Command window and in the enter the 
following command: 
drt 


From the Displays menu, choose Emulator Trace. 

The Frame numbers on the far left of the trace are used to 
reference when in trace history the information occurred. 
Frame 0 is the end of trace. The smaller Frame numbers are 
the last cycles captured prior to a “break” in emulation. 

The other raw trace columns show the address (Address), data 
(Data), status of various CPU signals, and timestamp 
information for each bus cycle captured. 


10-44 


MWX-ICE User's Manual (Windows) 



Searching trace history for a pattern 

To search trace memory for patterns, use the tsrch (ts) 
command, or the Search button from the Emulator trace 
window. 

Using the tsrch command, you can quahfy the search with 
combinations of address, data, statue, and logic state analysis 
patterns. You can also specify a starting Une number in trace 
history. 

In the Emulator Trace window, you can use the Search button 
to search trace for specific text strings. 

> To search trace history for an access to address 
0x80000430 

■ In the Enter Command box, enter: 
tsrch addr=0x80000430 && stat=wr 


Displaying disassembled trace history 

Use dtb (display trace backwards) for displaying the trace 
buffer information formatted in assembly or high-level mode, 
or as an interleaving of both modes. The dtf (display trace 
forwards) command performs the same trace display function, 
but in a different direction. Use the dt command with a start 
address to begin disassembUng at a particular line in trace. 

The trdisp MWX-ICE variable controls the disassembled trace 
display mode. The variable’s default (both) causes an 
interleaving of assembly and source. 

> To display the trace information in disassembled format 

■ In the Enter Command box, enter: 
dtb 

The numbers on the far left of the disassembled trace 
correspond directly to the Frame numbers on the far left of the 
raw trace display. They are useful when correlating a line of 
disassembled trace to its bus cycle equivalent line in raw trace. 


SuperTAP 8XX 


10-45 



Observe the call to houseO. Notice the branch and link (bl) 
instruction in the disassembled trace display, which also shows 
the non-sequential changes to the IP. The previous IP is shown 
in the form address > IP. The new IP is shown in the form 
IP < address. If you look at the Code window in Assembly mode, 
you can see that the new IP address matches the current 
execution address in the Code window. 

Saving trace to a file 

You may need a hardcopy of trace or a copy of trace on disk for 
later referencing. Or, you may have a problem that requires 
factory support. The AppHcations department might request a 
hardcopy of trace memory to assist in solving the problem. 

Earher we discussed the journal (jou) command [Journal 
page in Debugger Files notebook], which records both the 
commands and their output into a file. You can use the journal 
command to save a partial or entire trace disassembly into a 
file. The example below shows how to save a trace memory 
display to a file. 

For example, the following commands save part of a raw trace 
to a file named trace.raw: 

jou on="trace.raw" 
drt 0..42 
jou off 

The command jou on=*^race*raw” creates a file named 
trace.raw as the journal file. The command drt 0..42 displays 
raw traces lines 0 through 42. This display goes to both the 
Command window and the journal file. The command jou off 
stops recording and closes the journal file. 

Using the /a option with jou allows you reopen and append to 
an existing file. 

Capturing trace in pause mode 

An emulator softswitch, ppt, controls the capture of additional 
information. With ppt on you can capture bus cycle 
information generated by MWX-ICE memory read and write 
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commands such as setmem, fill, copy, diag, and others. This 
trace information can assist you in diagnosing general memory 
problems or memory errors that may have shown up in one of 
MWX-ICE’s RAM diagnostic tests (diag). 

Also, with ppt on, cycles generated by MWX-ICE memory 
commands or by downloading code widi the load command are 
included in trace memory. The load command cycles can be a 
valuable somce of troubleshooting information when a 
download fails for some reason. You can examine the last cycle 
in trace memory and determine if the download went to valid 
RAM memory, nonexistent memory, or ROM, for example. 

Executing MWX-ICE commands in run mode (dynamic run mode - drun) 

The drun command lets you use MWX-ICE commands without 
stopping program execution (lun mode). 

For instance, you may want to examine trace history (drt or 
dtb) while executing your program. If you enter run mode 
using drun instead of go, you can use the drt command to 
display the trace history, gathered up to the point where you 
entered the drt command, while the target program continues 
to run. 

To exit dynamic run mode use the dstop command. 
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>■ To restart) enter d3niamic run mode) then display raw 
trace history 

1. In the Enter Command box, enter: 

rest 

drun 

drt 

Examine trace. 

2. Restore the Command window to its previous size. 

> To exit dynamic run mode (dstop) 

■ In the Enter Command box, enter: 
dstop 


Timestamp 

In raw trace, the timestamp information shows either the time 
between successive bus cycles, or the time relative to a 
specified trace firame number. The following MWX-ICE 
variables control capturing and displaying timestamp 
information. 


timclk 

Selects timestamp clock resolution (40ns, 
200ns, lus, lOus, lOOus, 1ms, 10ms, or 
100ms). 

trstamp 

Display timestamp interval/offset when trace 
is displayed in the Command window. 

trbase 

Selects trace frame to use as timestamp base 
firame when trace is displayed in the 
Command window. 


Debugger macros 

Macros provide an efficient means of executing repetitive tasks 
or generalizing a task that originally acted on only a specific 
item. MWX-ICE uses the same C-like sequence of expressions. 
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statements, and debugger commands as XRAY to define and 
invoke macros. See the XRAY Debugger for Windows Reference 
Manual for an explanation on how to generate your own 
macros and how to use the predefined macros that come with 
MWX-ICE. The following section demonstrates briefly how to 
create a macro and then save it into an “include” file that can 
be executed by the debugger. 

Creating a macro 

Use the Macro page of the Symbol Management notebook to 
create a macro. This puts MWX-ICE in the macro define mode. 

When you use a keyboard command in a macro you must 
precede and follow the command with a dollar sign ($). 

Below, you create a macro demonstrating using the aliased 
command drt. 


> Define a macro named dmp.trc 

1. From the Notebooks menu, choose S 3 nnbol Management. 

2. From the Symbol Management menu, choose Create or edit 
a debugger macro. 

The S 3 rmbol Management notebook opens to the Edit Debug¬ 
ger Macro page. 

3. In the Specify Macro Name field t 5 rpe: 
dmp_trc 

4. Choose Edit. 

5. Edit the file in the File Editor window to match the following 
by adding the hnes shown in bold type: 

define diip_trc() 

{ 

$ 

drt 

$ 

# 

} 
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6. From the File menu of the File Editor, choose Save, to save 
the macro. 


7. From the Debugger Macros menu of the File Editor, choose 
Send Macro to Debugger. 

8. From the File menu, choose Save and Exit. 

9. Close the S 3 nnbol Management notebook (ALT + F4). 

Displaying a macro 

Use the show command to display an active macro in the 
Command window. The macro is displayed in the Command 
window. You may need to enlarge the window to view it. (To 
edit a macro, enter its name in the field of the Macro page of the 
S 3 nnbol Management notebook, and choose Edit.) 

> To display the macro dmp Jrc 

■ In the Enter Command box, type sh dmp_trc 

Assigning a macro to a breakpoint 

A macro can be assigned to a breakpoint by setting a 
breakpoint and following it with your^macroO’'. The macro is 
executed when the breakpoint occirrs. 

> To assign macro "dmp__trc” to a write access breakpoint 
at ‘Ted jport” 

■ In the Enter Command box, enter: 
bw led_port; dirp_trc () 

> Restart) then go until the breakpoint is reached 

■ In the Enter Command box, enter: 
rest 

g 

When the breakpoint at Ted_port” occurs, emulation stops, and 
raw trace information is immediately displayed in the 
Command window. 
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>- To clear write breakpoint number 1 

■ In the Enter Command box, enter; 

cl 1 

Deleting a macro 

Use the delete command to delete a macro. For example, the 
following command deletes a macro called big_mac: 

del big_mac 

Saving a macro to an “include” file 

After you determine that your macro works, you may want to 
save it to a file for later use. The resulting file can be used as 
an include file that recreates the macro. 

>■ To save a macro to a file 

1. From the Notebooks menu, choose S 3 rmbol Management. 

2. From the Symbol Management menu, choose Create or edit 
a debugger macro. 

The S 3 anbol Management notebook opens to the Edit Debug¬ 
ger Macro page. 

3. In the Specify Macro Name field, select the name of tbe 
macro that you’ve created, then click the Edit button. 

4. From the File menu of the File Editor, choose Save As: 

5. In the dialog box, type: 
dmp_trc.inc 

6. In the dialog box, choose Save, to write the macro into the 
file DMP_TRC.INC. 

If a macro is no longer present in the Edit window but has been 
loaded into the debugger, you can still save it to a file. 

For example, the following commands save and invoke a macro 
using the command line. 

fopen 60, "dmp_trc.inc" 
show dinp_trc,60 
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vclose 60 


The command fopen 60 creates a file named DMP^TRC.INC in 
the current directory; include a path if you want it saved 
elsewhere. (The number after fopen used must be greater than 
50.) The file contains the commands necessary to create the 
macro dmp_trc, placed there by the show command. The 
command vclose 60 saves the file. To enable the macro in 
future sessions, you must first invoke the include file: 

inc dmp__trc. inc 

Then you can use the macro. 


Note 



You can also define a macro in a text file, and include that file 
from the command line of the Command window. For correct 
syntax, see the examples provided for the define command in 
Help. 


Using the event system 

Sometimes running to a basic breakpoint and examining trace 
history does not provide information specific enough to debug 
your targets code or hardware. Also, you may want the 
emulator to perform some action other than breaking when the 
conditions become true. You may need to trigger an oscilloscope 
after a complex set of CPU bus cycle conditions become true, or 
to trace only certain types of bus cycle information under 
certain conditions. For example, the conditions might be the 
fifth write that a specific subroutine makes to a certain I/O 
location. 

The event system can be useful when implemented as a built- 
in bounds checker for the executing program. Simply set up the 
event system to cause a break in areas of memory that nothing 
should access. 
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The event system supplies the mechanism to define conditions 
and execute actions through user defined “when event^then 
action” statements. This mechanism allows the emulator to 
perform various actions based on events of complexity far 
surpassing that of simple breakpoints. 

This section will help you get started using the event S 3 rstem. 
Comprehensive user information and descriptions of aU 
available conditions and actions are in Chapter 7, “Using the 
Event System.” 

General information 

The event system is implemented with emulator hardware and 
can be used in both RAM and ROM regions. 

Setting up whenfthen event statements 

The first step in setting up a when/then statement is deciding 
what condition(s) you need to include. For most simple address 
and status conditions you probably need only an access 
breakpoint. We begin with those conditions however, to keep 
the first event statement simple. 

> To define a when/then statement to cause a break on 
any write to “led_port” 

■ In the Enter Command box, enter: 

when addr==&led_port && status== wr then break 

The command is made up of the followii^ elements: 

□ adar==&i«djport defines the address of “led_port” as the 
address of interest. 

□ status==wr defines the access to “led_port” as a write, 
a && is the logical AND operator. 

a break stops emulation. 
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The event is assigned event number 1 and is displayed in the 
View window, shown in Figure 10-10. If you have minimized 
the View window as an icon, you need to open it. 



Rgure 10-10 View window for viewing event system setup 
> To run the program until the event occurs 
■ In the Enter Command box, enter 

rest 

g 

The Command window displays a message that an “Event 
break occurred”, caused by “When statement #1.” In the Code 
window you should see a highhghted source line indicating 
where the break occurred. You can scroll up to see where the 
write to led_port occurred. 

Assigning a macro to an event system “break” action 
(breakcompiex) 

You can use the hreakcomplex (be) command to tie a macro 
to an event system “break” action. 

In general, to set up for a breakcompiex: 

1. Set up the event statement. 

2. Tie the macro to the event statement number using the be 
command. 
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For example, the following commands attach the macro 
dmp_trc() to an event system trigger. This example assumes 
the event is event niunber one. 

when addr==&led_port && stat==wr then break 
be 1; dinp_trc () 


Additional event system features 

In addition to the simple conditions and actions illustrated 
here, the event system possesses many advanced features such 
as groups, counters, timer, flags, conditional tracing, trigger 
generation, and others. These featxires are covered in 
Chapter 7 of this manual. 

Scope loops and diagnostics 

Built in scope loops and memory diagnostic programs are 
included with the debugger in the form of diag commands. 
These programs save you from writing your own routines to 
test memory or to stimulate memory for “scoping” or logic 
analysis. 

Another diagnostic, named cre, calculates the CRC-16 (cyclic 
redimdancy check) over the desired range. 

Memory and 10 read/write scope loops 

Diagnostics 2 through 7 are used to perform reads and/or 
writes of selected memory with patterns chosen by the user. 

> To perform a continuous read 

1. In the Enter Command box, enter: 
diag 2,0x80000000..0x80000100 

2. Press the Stop button to stop die test. 

Memory diagnostics, simple and complex 

Diagnostic numbers 0 and 1 perform simple and complex 
diagnostics on the selected memory. 
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> To perform a complex memory test 

1. In the Enter Command box, enter: 
diag 0,0x80000100..0x80000200 

2. Press the Stop button to stop the test. 

Cyclic redundancy check 

Use the crc command with a range argument to perform a 
CRC-16 of the specified range. The command will return a hex 
value for the CRC. 

> To perform a cyclic redundancy check 

■ In the Enter Command box, enter: 
crc 0x80000100..0x80000200 
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Using the SuperTAP — practical examples 

This section contains practical examples demonstrating using 
the emulator in common debugging situations including: 

□ Tracing a particular subroutine 

□ Capturing “qualified''trace history 

□ Capturing and viewing trace while running 

□ Displaying structures 

□ Browsing the CPU registers 

□ Displaying and modifying memory 

□ Monitoring and modifying variables while nmning 
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Example 1 - Tracing a particular subroutine 

In the example, you set up trace triggering so that only the 
cycles within a certain subroutine run() are traced. To do this, 
you define a dual-event trace trigger that starts trace capture 
when runO is entered, and stops trace capture when run() 
transfers program execution. 

> To restart the Cdemon program 

■ In the Enter Command box of the Command window, enter: 

restart 

> To set up initial trace conditions 

1. In the Enter Command box, enter: 
trinit off 

This keeps trace capture tximed off unless enabled by the 
event system or the trace on command. 

2. In the Enter Command box, enter: 
trqual dxqual 

This ensures that sufficient information is captured for the 
most accurate disassembly of trace. 

3. In the Enter Command box, enter: 
trrunclr on 

This clears the trace buffer when the emulator enters run 
mode. 

> To set up event statements to start and stop tracing 

1. In the Enter Command box, enter: 
ps outled 
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From the output of the printsymbols (ps) command, we can 
easily determine the beginning and end address of the func¬ 
tion outledO. 





^ > ps outlsd 


i 

i 0(JTLED\outl«d 

: Global Function rotuxning woicl. 


bddross = FFF023B0 to FFF024CC 



Argunonts: f void} 

|a 



111110 


Figure 10-11 Printsymbols output for outledO 


2. In the Enter Command box, enter: 
when addr==0xFFF023B0 then tron 

This event statement turns tracing on at the start address of 
the function outledO. Notice a View window is opened when 
you enter the command. 

3. In the Enter Command box of the Command window, enter: 

when addr==0xFFF024CC then troff,break 

This turns tracing off at the final address of the function 
outledO, then breaks emulation. 

4. In the View window, examine both event system statements. 
See Figure 10-12. 



Figure 10-12 Event system “turn trace on’ and “turn trace off event statements 
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>■ To run until the break condition is met 

■ Click the Go button. 

> To view mixed source and assembly level disassembled 
program execution history 

1. From the Displays menu, choose Emulator Trace. 

The Emulator Trace window is displayed. It may take a few 
moments before the raw trace appears. See Figure 10-13. 

2. From the View menu, choose Show source trace and clear 
Show raw trace. 

A check mark appears next to the Show option selected. No¬ 
tice that only the source lines for the subroutine outledO are 
displayed in the trace. See Figure 10-14. 

3. From the View menu, select Show assembly trace. 

Notice that only the source lines and their associated assem¬ 
bly code for the subroutine outledO are displayed in the trace 
buffer window, shown in Figure 10-15. 

>- To clear the event system 

■ In the Enter Command box, enter: 
whenclr all 
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Figure 10-13 Raw trace display of the subroutine outled() 


SuperTAP 8XX 


0 - 6 - 





































fMWX-ICE Debugger 


Fie £iit displays notebooks jkclioiis 


\fi9ndow Help 


Show raw trace 
Show ass eaiibF trace 


: ✓ Show source trace 



^MWXST880(hazzle] > Code 


V Display tiawitaaip as Offset 
Display tiiaestao«i as Itrterval 


94 » 

95 ?EEI 

96 

97 j» 

98 t» 

99 

100 i» 

101 

102 i» 

103 

104 

105 

106 ?» 
107 


for (aaskbit = 1, 
led_portIi++l 
l*d_port[i++l 
led_portIi++J 
for (aaskbit = 1, 
for jaiaskbdt = 1, 
le4_portCi++I 
l«4_port(i^+] 
l«d_port[i^+l 
for (aaskbit = 1, 
for (BAskbit = 1, 
l«d_port[i] = ' I • 


Show precerfing source coaweritT 

~= 6 ; i <1^; Boskloat «= 1) 

= 0 7 i < 16; SMurkbit «- 1) 

' I '; /'•' start vitb a freoui */ 

(data & Boskbit) 

(data & Boslcbit) ? ' ' : ' *'; 

= 0 ; i < 16; Boskbit «= 1} 

= 0 ; i < 16; Baskbit «= 1) 

* I '; /* start with a freusc */ 

(^ta & Baskbit) ? ' ' : '*'} 
(data 6 Baskbit) ? ' ' : j 

= 0 ; i < 16; Baskbit «= 1) 

= 0 ; i < 16; Baskbit «= 1) 

/* finish with on« last f: 




Figure 10-14 Source trace display of the subroutine outledO 
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Figure 10-15 Mixed source and assembly trace display of the subroutine 
outtedQ 
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Example 2 - Capturing qualified trace history 

Quite often there will be only a few cycles of interest out of the 
milhons of cycles executed in a real-time run of the code. There 
are two ways of dealing with this: 

1. Capturing, in real-time, a trace of only the cycles of interest. 
This is a qualified trace. 

2. Post-processing (filtering out unwanted cycles) a large and 
expensive trace RAM buffer full of all executed and pre- 
fetdied instructions. 

The first is by far a quicker and more accurate method than the 
second. With SuperTAFs four-level event system architecture 
and trace control actions, you can capture a qualified trace 
based on a complex set of conditions, includingprogram events, 
target hardware events, and the CPU bus state. 

The example demonstrates this abiUty by capturing only the 
first ten memory write cycles directed to the memory-mapped 
LED port (address OxAOOOOOOO). 

>- Tracing 10 writes to the LEDs 

1. Restart the Cdemon program. 

In the Enter Command box of the Command window, enter 

restart 

2. Set up the qualified trace capture: 

In the Enter Command box, enter: 
trinit off 

This keeps trace capture turned off unless enabled by the 
event system. 

3. In the Enter Command box, enter: 

trrunclr on 
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This clears the trace buffer when the emulator enters nm 
mode. 

4. In the Enter Command box, enter: 
trqual dxqual 

This configures trace for bus qualified capture. 

5. In the Enter Command box, enter: 
ctrlival reload 

This resets the counter to zero when entering nm mode. 

6. In the Enter Command box, enter: 

when addr==dot_j>ort && status==wr then trone, ctrlinc 

Note: dot j)ort holds the base address of the LEDs 
(OxAOOOOOOO). 

7. In the Enter Command box, enter: 
when ctrl==10 then break 

> To run the target code 

■ Click the Go button. 

SuperTAP breaks emulation after tracing the first 10 writes 
to the memory-mapped I/O address. 

> To display trace 

1. From the Displays menu, choose Emulator Trace. 

2. From the View menu, select Show raw trace. 

You may need to scroll to see all of the trace. Only the 10 
write cycles have been captured (Figure 10-16). 

> To clear the event system 

■ In the Enter Command box, enter: 
whenclr all 
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Example 3 - Capturing and viewing trace while running 

In this example, SuperTAP emulates in d 3 mamic mode; you can 
display trace while still emulating. You capture the run() 
function in trace using the event system, then view the trace in 
raw and disassembled formats. 

> To restart the Cdemon program 

■ In the Enter Command box of the Command window, enter: 
restart 

> To set up the initial trace condition 

1. In the Enter Command box, enter: 
trinit off 

This keeps trace capture turned off unless enabled by the 
event system or the trace on command. 

2. In the Enter Command box, enter: 
trrunclr on 

This clears the trace buffer when the emulator enters run. 

3. In the Enter Command box, enter: 
trqual dxqual 

This configures trace for disassembly quahfied capture. 

> To set up event system 

1. In the Enter Command box, enter: 
when add==0xFFF02204 then tron 

2. In the Enter Command box, enter: 
when add==0xFFF02284 then troff 

The Command window should display the two event system 
statements shown in Figure 10-17. 
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Figure 10-17 Event system statements to turn trace capture on and off 


> To enter dynamic run mode 

■ In the Enter Command box, enter: 
drun 


> To display a ^snapshot’’ of trace while still running 
target code 

1. In the Enter Command box, enter: 
drt 

This displays trace history in raw format in the Command 
window. 

2. In the Enter Command box, enter: 
dtb 

This displays trace in mixed source and assembly mode 
(trdisp both is the default mode). Assembly and soxirce-lev- 
el only modes are also available using the trdisp command. 
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Figure 10-18 Dynamic trace display - disassembled source and assembly 


>- To exit dynamic run mode and clear the event system 

1. In the Enter Command box, enter; 
dstop 

2. In the Enter Command box, enter: 
whenclr all 

This clears all event system statements. 
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Example 4 - Displaying data structures 

Symbols include arrays, structures, static variables, register- 
based, and stack-based variables. S 3 rmbols can be displayed or 
changed by name, as declared in your program. You can display 
the type and scope of each s 3 mibol, and its value in binary, hex, 
ASCII, or decimal format. 

> To restart the Cdemon program 

■ In the Enter Command box of the Command window, enter: 
restart 

> To run to houseO^ a function in dataO 

■ In the Enter Command box, enter: 
g DATA\house 

Emulation breaks at the beginning of houseO, a function 
within dataO. At this point, all of the cards have been dealt. 

> To display the structure players 

1. From the Displays menu, choose Inspector. 

2. In the Inspect Symbol or Expression box, enter the following: 
players 

The Inspector window displays a break down of players. You 
can scroll or resize the Inspecting window for the best dis¬ 
play of the structure. 

3. From the View menu, choose Show [char*] as String. 

4. In the Inspector window, choose S» for player[02]. 

The Inspector window displays a break down of player [02], 
the third element of players. 

In Figure 10-19, you can see player 1 busted, having been 
dealt 5 cards for a total of 23 points. Too bad. 

5. Close the Inspector window. 
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Example 5 - Browsing the CPU registers 

MWX-ICE includes a register utility called the CPU Browser, 
to save you time you might otherwise spend referencing a 
technical manual for register bit meanings. 

> To browse the SR register 

1. From the Displays Menu, choose CPU Browser. 

2. From the CPU Browser window, click the MSR button 

The CPU Browser displays the current MSR register 
settings. 

3. Close the CPU Browser window. 
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Figure 10-20 The CPU Browser view of the Status register 
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Example 6 - Displaying and modifying memory 

MWX-ICE provides means for acting on a block of memory. 
Using either the command line or the Memory Commands 
notebook, you can clear, move, set, read, write, or log a block of 
memory. 

> To restart the Cdemon program 

■ In the Enter Command box of the Command window, enter: 
restart 

> To display memory 

■ In the Enter Command box, enter: 
duinp &led_port 

This displays a block of memory in the Command window 
beginning with the address of ledjport. (Note: You can also 
use the Memory window. To open this window, choose Mem¬ 
ory from the Displays menu.) 

> To manipulate a block of memory 

1. From the Notebooks menu, choose Memory Commands. 

2. The Memory Commands menu, choose one of five 
commands. 

The Memory commands notebook is displayed. You can select 
notebook pages by clicking the notebook tabs. The notebook 
pages control memory commands: 

□ Fill—^fill memory with a given value. 

□ Copy—copy the contents of one block of memory to another. 

□ Compare—compare the contents of two memory blocks. 

□ Search—search through memory for a pattern. 

□ Stack—display values from a particular stack level. 

The Fill page is shown in Figure 10-21. 
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Example 7 - Monitoring and modifying variables 

MWX-ICE provides three windows for working with program 
variables. The Data window is used for monitoring variables, 
the Inspector window for viewing and modifying variables, and 
the Register window for viewing and modifying register-based 
variables. In static mode, they are updated only at each single- 
step, breakpoint, or program halt. In dynamic mode, emulation 
periodically pauses then re-starts, updating each window when 
emulation is re-entered. 

> To dynamically monitor the variable led_port 

1. In the Enter Command box of the Command window, enter: 

g outled 

2. From a Displays menu, choose Data. 

3. In the Data window Expression box, type ledjport, and 
then click the Display button: 

This places the variable ledjort in the Data window. 

> To restart the Cdemon program 

■ In the Enter Command box of the Command window, enter: 
restart 

> To enter dynamic run mode 

■ In the Enter Command box, enter 
drun 

> To enter dynamic update mode 

■ In the Enter Command box, enter: 
dupdate 1000 

This causes MWX-ICE to poll the emulator approximately 
1000 times a minute. The response is actually slower due to 
the time spent updating the debugger’s windows. 
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Observe the variable led_port in the Data window as it 
changes. 

> To exit dynamic update mode 

■ Choose Stop from the tool bar. 

> To dynamically modify the variable direct 

1. From the Displays menu, choose Inspector. 

2. In the Inspector window Symbol Name box, enter the 
following: 

direct 

The variable direct controls the direction of the LED's count¬ 
ing, either left or right. 

3. In the Inspector window, choose the long button to the left of 
the value left. 

This opens up a dialog box used to change the value of the 
inspected variable, shown in Figure 10-23. 

4. In the Enter new value field of the dialog box, type: 
right 

5. In the dialog box, choose Set to accept the new value. 

The Inspector window for direct now reflects the new value. 

6. Enter d 3 mLamic update mode again: 
dupdate 1000 

Observe the motion of the asterisks displayed in the Data 
window. 

7. Choose Stop from the tool bar to exit dynamic update mode. 

> To exit dynamic run mode and return to pause mode 

■ In the Enter Command box, enter: 
dstop 

This forces SuperTAP firom d 3 mamic run mode back into 
pause mode. 
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Figure 10-22 Dynamic mode - Monitoring the variable led_port 
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Rgure 10-23 Dynamic mode - Entering a variable’s new value 
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Appendix A 

Modifying the Startup Files _ 

To save you time in setup and configuration of MWX-ICE, you 
can save your emulator connection and configuration 
information, and your startup command-line arguments. 
MWX-ICE saves this information in two separate files. This 
appendix describes how these two startup files interact, and 
describes the process used by MWX-ICE at startup. 
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How MWX-ICE uses the startup files 

When you start MWX-ICE, the debater automatically looks 
for the MWXCFG file to obtain the command-line or startup 
options. The MWX.CFG file is created by the Startup Options 
Editor. When you first use MWX-ICE, you need to run the 
Startup Options Editor to select the correct processor type. 
Using the Editor, you can also specify an absolute file to 
download, select journal or log files to record yom: debugging 
session, include command files. You can also specify a Startup 
Settings file to use, which then overrides the default file 
(STARTUP.INC). 

After MWX-ICE has obtained the command-line arguments, it 
looks for the STARTUP.INC file, or for a Startup Settings file 
if you specified one using the Startup Options Editor. This file 
contains the emulator configuration and connection 
commands, and is processed before any other include files. 
MWX-ICE automatically looks for this file at startup. The 
STARTUP.INC file is created when you save your 
configuration. 

After all the commands in the STARTUP.INC file have been 
executed, MWX-ICE finishes processing the rest of the 
command-line options. 

For an illustration of how MWX-ICE uses the startup files, see 
Figure A-1. 
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figure A-1 How MWX-ICE uses the STARTUP.INC and MWX.CFG files. 
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About the startup file (STARTUP.INC) 

The startup file is a special kind of include file that is processed 
before any other include files. This file has a configuration 
section that is composed of three parts: the first part contains 
the definitions of emulator connections (using the config 
command); the second part connects to a specific emulator 
(using the connect command); the third part contains the 
configuration commands. Do not edit the configuration section 
of the startup file. The configuration commands cannot be 
processed if MWX-ICE is not connected to an emulator. 



;;; TOP OF SECTION 


Defines connections— 

Connects to emuiator— 

; ; ; DO NOT MODIFY COMMANDS 

IN THE FOLLOWING SECTION. 

config prodsupt, ETHERNET, prodsupt 
config bxibba, ETHERNET, bubba 
connect prodsupt 

Configuration— 
commands 

option LINES = OFF 
option SYMBOL = ON 



DNLFMT SREC 

RUN_POLL 5 

RUN_TIME 0 

UPLFMT SREC 

VERIFY ON 

DNL_GAP 0 

BERRS OFF 

BTE ON 



; ; ; DO NOT MODIFY COMMANDS 
;;; END OF SECTION 

ABOVE THIS LINE. 


Figure A-2 The configuration section of an example of a STARTUP.INC file 
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Where MWX-ICE looks for the STARTUP.INC file 

MWX-ICE searches the following directories for the 
STARTUP.INC file: (note that XRAYMASTER is the directory 
pointed to by the XRAYMASTER environment variable): 

Q currentjUrectory 

□ curr€7it_£iirccto/y\AMC\ST8XX 

□ XRAYMASTER\AMC\ST8XX 

□ C:\ST8XX\AMC\ST8XX 

XRAYMASTER is the directory pointed to by the 
XRAYMASTER environment variable. If the STARTUP.INC 
file isn’t found, MWX-ICE comes up in an unconnected state. 
By default, when you save a configuration to the startup file, 
you are prompted to save the connection and the configurations 
to the STARTUP.INC file in your C:\ST8XX\AMC\ST8XX 
directory. 

Adding commands to the startup file 

You can add commands not normally saved as part of 
configuration. Using a text editor, place such commands after 
the configuration section of the startup file. This section ends 
with: 


A 


; ; ; DO NOT MODIFY COMMANDS ABOVE THIS LINE. 

;;; END OF SECTION 

For example, you could call an additional include file: 

; ; ; DO NOT MODIFY COMMANDS ABOVE THIS LINE. 

;;; END OF SECTION 
inc ittyregs. inc 

To preserve such additions to the file, always use Replace, 
rather than Overwrite, when saving new configuration data to 
the file. 

To process the commands at startup, MWX-ICE must be 
connected to an emulator. For a hst of all the commands and 
their descriptions, see MWX-ICE Help. 
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Modifying the Startup 
Files 




Including a specific startup file 

By default, MWX-ICE searches for the STARTUP.INC file. You 
can override an existing startup file by specifying another file 
to use. 

> To include a specific startup file 

■ From the Startup Options Editor, select a Startup Settings 
file. 

Changing connections during a debug session 

Once MWX-ICE is running, you can run a startup include file 
as long as you are not connected to an emulator. Just make 
sure you are connecting to an emulator that matches the 
processor type you selected using the Startup Options Editor. 

> To include a startup file fi*om MWX-ICE 

■ From the Connections window File menu, choose Run 
Include. This opens the Include page of the Debugger Files 
notebook. Type the name of the file, or use the File Chooser, 
and then click Include. 

—or— 

■ Use the include command firom MWX-ICE Command 
window. 

Restoring emulator default settings 

Once you create a startup include file, MWX-ICE uses the 
definitions and configuration in that file. If you want to reset 
the emulator to its default state, follow these steps. 

> To restore default settings 

1. Exit MWX-ICE. 

2. Tvun off power to the target and emulator. 

3. Rename or delete the existing STARTUP.INC file(s). 
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Note that MWX-ICE looks for the STARTUP.INC file in sev¬ 
eral locations. See “Where MWX-ICE looks for the START¬ 
UP.INC file” on page A-5. 

4. Start MWX-ICE. 

5. Turn on power to the emulator and target. 

6. Define a connection, and connect to an emulator. 


About the startup options file (MWX.CFG) 

To make selecting startup options easier, you can use the 
MWX-ICE Startup Options Editor. The editor creates a startup 
options file (MWX.CFG) that is automatically included when 
you start the debugger. 

The debugger automatically looks for the file MWX.CFG, and 
uses those options at startup. If you save the options to a 
different file, you need to specify the name of the file in tJie 
command line at startup. 



Figure A-3 MWX-ICE Startup Options Editor 
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Rgure A-4 MWX-ICE Startup Options Editor Advanced Options 

Specifying which startup option file to use 

The debugger automatically looks for the file MWX.CFG, and 
uses those options at startup. 

If you save the options to a different file, you need to add a new 
program icon to the Start or Programs menu. For information, 
cUck Help from the Startup Options Editor, and see the “Add a 
new program” topic. 
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Selecting startup options 

You can select the following startup options. For more 
information about each option, choose Help from the Help 
menu, click the Help button, or press FI. 

Table A-1 Basic options provided by the Startup Options Editor 


Options 

Definition 

Processor 

When more than one, selects the processor variant that you 
want. This is the only change necessary to switch variants. 

Load Symbols Only 

Loads only the symbols of the file specified in the Load 
Absolute File field. 

Load Absolute File 

The name of an absolute object module that is loaded into the 
debugger’s simulated target memory. The default extension 
is .ABS. Use an absolute pathname, if the file is not in the 
directory firom which MWX-ICE was started; or set the XRAY 
environment variable to point to source locations. 


Only one absolute object module may be loaded into MWX- 
ICE via the startup editor. To load multiple absolute object 
modules, use the load command after starting the debugger. 


Table A-2 Advanced options provided by the Startup Options Editor 

Options 

Definition 

Load Include File 

The name of an mcluded command file that is read before 
any debugger commands are entered. The default file 
extension is .INC. Use an absolute pathname, if the file is not 
in the directory firom which MWX-ICE was started; for 
example, \PROJECT\JOHN\SWITCHES.INC. 
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Options 


Table A-2 Advanced options provided by the Startup Options Editor 

Definition 


Specify Journal File 

Command output and window information is saved in the 
specifiedyourna^Jz/e. The default extension is.JOU. This file 
is placed in the directory from which MWX-ICE was started, 
unless 3 rou specify a complete path; for example, 
\PROJECT\ADMIN\TEST5.JOU. 

Specify Log File 

User commands and a record of any errors are placed in the 
specified logjile. The default extension is .LOG. This file is 
placed in the directory from which MWX-ICE was started, 
unless you specify a complete path; for example, 
\PROJECT\ADMIN\TEST5.LOG. 
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Appendix B 

Troubleshooting 


The following list covers the most common problems that occur 
during installation and using MWX-ICE. They are grouped 
according to when the failure typically occiirs: 

□ During startup. 

□ During normal operation. 


Each group consists of one or more problems. Locate the 
problem that suits your situation, and check the causes and 
solutions listed. Where problems are specific to a particular 
host or communications type, it is noted. 
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Common startup problems 

Here are some common problems that you might encoxmter 
when you try to nm the MWX-ICE debugger. 

If MWX-ICE fails to start, or exits suddenly, check the 
following possible causes. 


Insufficient memory 

To use MWX-ICE you must have a 386-class personal computer 
(or better) running MS Windows 95 or Windows NT. You need 
at least 16 MB of RAM and 20 MB of free swap space (Virtual 
Memory). 

An MWX-ICE support file was not found 

An MWX-ICE support file is missing or not in the search path. 
MWX-ICE searches the directories in the following order 

□ curr«raf_dir«cfo/y\STARTUP.INC 

□ current_directory\AM.C\ST8XX.\ 

□ XRAYMASTER^AMC\ST8XX\ 

□ C:\ST8XX\AMC\ST8XX\ 

The default installation directory for MWX-ICE is C:\ST8XX. 
If you use this directory, you do not need to set up the 
XRAYMASTER environment variable. 

If you have installed the MWX-ICE debugger in different 
directory, you need to set up the XRAYMASTER environment 
variable in your AUTOEXEC.BAT file. The syntax is: 

set XRAYMASTER=iJ 2 StaII_dir 

MWX-ICE reports it cannot find the necessary shell file 

The emulator control file is missing or not in the search path. 


1. Directory pointed to by the XRAYMASTER environment variable. 
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The search order that MWX-ICE uses is shown on page B-2 

Check these locations for the .ep file. If you are not using the 
default installation directory (C:\ST8XX), be sure to set the 
XRAYMASTER environment variable to point to your 
installation directory. 

Error while opening a connection to the emulator 

MWX-ICE reports that the debug server is initializing, but 
nothing happens. 

Check the following; 

□ Is the emulator is connected to a power and is the power 
switch is on? 

□ Is the emulator connected properly to the host computer or 
network? 

□ Is STARTUP.INC file set up correctly for the type of 
commimications you are using? 

□ Is the emulator properly mstalled on your network? 

Check the communications type 

Check that the Connection Type for the defined connection 
matches the switch settings on the emulator. For information 
about communications setup, see “Defining a connection” on 
page 2-9. 

Check emulator connections 

If you are using Ethernet communications, tighten the 
Ethernet cable connection between the emulator and network. 

Check the host name for the emulator 

The host name you are using for the emulator and the host 
name specified in the Connections window must match. 

If your TCP/IP application provides the PING program, you 
can use it to test the connection to the emulator. PING sends 
ICMP_ECHO_REQUEST packets to a remote host. From your 
computer you can ping the emulator to determine if it is 
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accessible. The PING command should report Ihe emulator to 
be alive. If not, the emulator has been installed incorrectly, and 
you might need the assistance of your network administrator to 
correct it. Verify each step of the Ethernet installation given in 
the hardware manual. Check your network HOSTS files or 
domain name system services, and your TCP/IP setup. 

If the PING works, shut the emulator off and try again. You 
want to make sure that you are indeed talking to the emulator. 
With the emulator off, the ping should &il. If this happens, you 
have the correct address of the emulator, so turn it back on. 

Check WINSOCK.DLL 

The file WINSOCKDLL must be Windows Sockets version 1.2 
compliant Make sure this file is in your Windows directory, or 
in your environment path. Without a version 1.2 compliant 
WINSOCKDLL, you won’t be able to connect to the emulator. 

If you get the error message ‘Terror while opening a connection 
to the emulator,” and you have the PING utility, try to verify 
that the emulator is on the network. If the emulator is on the 
network and you’ve used the correct host name for the 
emulator, you might need a newer version of WINSOCKDLL. 

Does your network use IEEE 802.3 frames? 

Ihe emulator communicates with the host using the standard 
IEEE 802.3 pa<h;ets. Be sure your network supports the IEEE 
802.3 format. 
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Download errors 


The following section lists some common errors that may occur 
during downloads to the target or to the emulator’s overlay 
memory. 

Virtual memory simulator failure 

MWX-ICE swaps S 3 mibols to disk and needs more disk space to 
continue. Clear disk space and try again. 


Lack of symbol space 

Not enough extended memory. 

MWX-ICE is storing symbols in extended memory, and has run 
out of space. You need at least as much memory available as 
the size of the object file being loaded, and usually you need 
about 25% more. So, if you are loading a 4 MB object file, you 
will need at least 16 MB of memory in your PC (12 for 
MWX-ICE, and 4 for the symbolic information). 


Miscellaneous errors 


B 


MWX-ICE reports the shell is newer or older than expected 

When you first run a new version of MWX-ICE, it is a good idea 
to select the Force OS Download in the Connections window, so 
the operating S 3 rstem in the emulator can be updated with the 
latest version provided on the distribution. 

Note that after you cycle power to the emulator, the emulator 
OS is automatically downloaded when you start the MWX-ICE 
debater. 
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Check paths and the XRAYMASTER variable 

You are encouraged to keep only the most current version of 
MWX-ICE on your system. If you choose to keep earher 
versions available, be sure to modify all path statements, 
environment variables, and user files containing file pointers 
(includes, start-up file etc.) to search the appropriate new 
paths. 

The search order that MWX-ICE uses is shown on page B-2. 

Check these locations for the .EP file. Remove any obsolete .EP 
from those locations, or reset your XRAYMASTER 
environment variable. 

Corrupted file 

If you suspect the .EP file is corrupted for some reason, try 
reinstalling MWX-ICE. After you install the debugger, select 
the Force OS Download in the Connections window, so the 
operating system in the emulator can be updated when you 
start the debugger. 

If MWX-ICE still reports a version error, please call Customer 
Support at 1-800-ASK-4-AMC. 

MWX-ICE reports “type errors” or “mismatched variables” 

A function or variable has been declared as more than one type 
in different modules. S 3 mibols for a module load only when that 
module comes in scope. When one of these warnings occurs, use 
ps /e/f to print the mismatch. You might need to use the scope 
\ module \symhol command in conjimction with the ps command 

to see the additional declarations of the S 3 nnbol. 

If you want to see all mismatches at startup, set option 
demandloadsoff; then load your code. A ps lelt command 
prints all known mismatches. Note that with demandload 
oflf, downloads can take considerable time, and you might run 
out of symbol space. 
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Calling Customer Support 

If none of the suggested solutions works, please contact the 
Applied Micros 3 rstems Customer Support department (US and 
Canada) or your nearest Applied Microsystems sales office 
(overseas). 

When you contact Customer Support, please have the following 
information available: 

□ The ASI ninnber of your system. The ASI number is printed 
on a label located on the bottom of the SuperTAP. 

□ Your Support Agreement number (if applicable). 

□ The emulation device you are connected to (68040 emulator, 
68332 CodeTAP, etc.). 

a The available conventional and extended RAM in your PC. 

□ The version of MWX-ICE you are using, as well as the 
information reported by the hwconfig command in the 
debugger (assuming you can get this). 

□ The exact sequence of operations and commands that 
immediately preceded your problem. 

Phone 

(800) ASK-4AMC (275-4262) 

(206) 882-2000 (in Washington or from Canada) 

See inside back page for addresses and phone numbers of 
worldwide offices. 
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Internet 

If you have access to the Internet, you can contact AppHed 
Microsystems Customer Support using the following address: 

support@amc.com 

If you have access to the World Wide Web, check out the 
Apphed Microsystems home page: 

httpy/www.amc.com 


FAX 

If you prefer, you can fax your problem description to us. Be 
sure to include the information requested above. 

(206) 883-3049 
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Appendix C 

Cdemon Demonstration Program 


Cdemon is the ^plied Microsystems standard C-language 
demonstration program, providii^ examples of many code and 
data constructions used by C programmers. An in-memory 
representation of the LEDs (led_port) may be used to see the 
output of some of the functions. 

Cdemon is composed of two discrete demonstration programs. 
The default C-language program writes to the LEDs and plays 
a simple hand of blaclgack. The other, a C++-language 
program, simulates an elevator. A variable named which_dejno 
determines which of the two demonstration programs is 
executed. The card game program runs by default. If 
which_demo is set to 1, then the elevator program is executed. 

Afunctional block of the LED-Hghting/blackjack game is shown 
in Figure C-1. 
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( START ) 



RgureC-1 Rowchart of Cdemon 


initialQ 

The function initialO initializes the three global LED-control 
variables, pattern, speed, and direct. These variables control 
the b 3 rte pattern, the speed, and the direction of LED pattern 
rotation, respectively. 

After initiahzing the global variables, initialO passes control to 
stepO. 

stepO 

The function stepO performs five loops of a simple LED control 
process, and passes control to dataO. 
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StepO declares the loop-control variable loops. In each of its five 
loops, stepO calls outledO 17 times, each time passing outledO 
a one-byte argument which represents the pattern displayed 
on the demonstration board LEDs. 

OutledO then writes the LED control b 3 rte to the LEDs and to 
an in-memory representation of the LEDs (symbolically named 
led_port). Each of the 17 arguments passed to outledO by each 
loop in stepO represents one LED pattern. 

While the execution of stepO can be observed with the trace 
function, the purpose of stepO is to demonstrate, in a 
single-stepped fashion, the relationship between the code and 
the LEDs. 

The most basic control of stepO comes from single-stepping 
while observing and modifying the loop-control variable loops. 
Loops may be observed with the Data window, and observed or 
chained with the Inspector window. Setting loops to a hig^ 
value will lengtdien the time spent in stepO, while setting loops 
to zero will very quickly cause program control to be passed to 
dataO. 

Because stepO produces a repeating cycle of data on file bus, 
predictable data-value conditions are available to the event 
system. 


dataO 

The function dataO plays a five-handed game of blaclgack with 
four players and a dealer. When the game is won, dataO passes 
control to nmO. DataO requires no input and generates no 
output, and is simply a code environment with interesting data 
structures. 

The primary data structures are; 

1. card, a structure defining the value and suite of each card. 

2. player, a structure containing each player's name, a hand 
(array) of five cards, a point total, and a card coimt. 
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3. card_deck, a union with various array types describing the 
cards in the four suits, the cards in the two sub-decks for 
shuffling, and the cards in the shuffled deck. 

After the declarations, dataO initiahzes player names and sets 
cards dealt and points for each player to zero, then executes the 
following functions. 

initO 

This function initializes players and dealer structures. 

sort() 

This function sets up a 52-word block of memory as a deck of 
cards. 

shuffle() 

This function divides the deck into two 26-word blocks and 
interleaves them, simulating the shuffling process. 

deal() 

This function deals one card to each player, including the 
dealer. 

m 

This function deals cards to each player untilpof/ifs >= 18, or 
cards dealt = 5. 

houseO 

This function deals cards to the dealer until points >= 17, or 
cards dealt = 5. 

The players each draw for cards while they have less than 21 
points and more than 18 points. The dealer uses a similar 
routine to draw cards until his hand contains more than 17 
points. The game concludes after one round. 

The dataO function only executes once. To replay the game, 
reset the program to return to the beginning of the code, and 
run the code until it reaches a temporary breakpoint set at the 
beginning of the dataO function. 
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runO 


The function run() writes a string from left to right (or right to 
left, depending on the value of the variable direct) to the LED’s 
endlessly. Rather than using separate statements like stepO, 
nmO uses a “while” control structure under the direction of the 
speed and direct variables from initial(). Program control stays 
with run(). 



RunO declares external functions outledO and waitO, declares 
the byte maskbit, the integer cputype, the loop-control variable 
i, and the constant forever = 1. ‘ 




outledO 

This function writes an 8-bit value to led_port, the in memory 
representation of LEDs. 


wait() 

This function sets the actual delay according to the value of two 
aig:iunents, cputype and speed. 


The mechanics of run() can be observed by changing the values 
of direct and speed, and then nmning without breakpoints. The 
effects of changed variables in the LED-control task can be 
observed directly at the LEDs or at the Data window while 
monitoring led_port. 
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Appendix D 

Updating the SuperTAP Flash ROM 


At some point you may be required to update the emulator 
firmware stored in the SuperTAFs flash memory. Typically 
this occurs when you are installing an update to existing 
software, and the release letter specifies a required higher level 
of emulator core software. 

This appendix describes Ihe steps in the upgrade process. 


Contents Page 

Part 1: Determine the current core version (optional) D-2 
Part 2: Activate the SuperTAFs core loader D-2 

Part 3: Program the emulator’s firmware D-5 

Part 4: Remove outdated shells and pointers D-7 
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Part 1: Determine the current core version (optional) 

To determine the current level of the emulator core software, 
you can use an MWX-ICE command. 

>• To check the core version 

1. Start MWX-ICE. 

Note that the most recently installed version of MWX-ICE 
may be incompatible with the core currently on the Super- 
TAP and fail to start. If this occurs, either start an earlier 
version of MWX-ICE, or skip this part and go directly to 
Part 2. 

2. Connect to the SuperTAP. 

3. Enter hwconfig on the command line. 

4. Compare the Core System and Core Loader versions 
displayed with those required by the latest release of MWX- 
ICE. If an upgrade is required, proceed with the remainder 
of the procedures in this appendix. 


Part 2: Activate the SuperTAP’s core loader 

>■ To activate the loader 

1. Turn off power to the SuperTAP. 

2. Using the EJ-ll adapter provided (P/N 210-12502 or P/N 
210-12503), connect the serial cable (600-12511) to the RS- 
232 port on your PC to the CONFIG port on the SuperTAP. 

3. Start HypeiTerminal or another terminal emulation 
program and connect to the COM port that is directly 
connected to the emtdator. 

Specify the following configuration parameters: 

■ 9600 baud 
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■ 8 data bits 

■ no parity 

■ one stop bit 

■ hardware flow control 

4. Apply power to the SuperTAP, and then watch the terminal 
screen. 

5. As the SuperTAP starts up, it displays information about 
the current loader and test engine, as soon as you see the 
message, “hit a key within 2 seconds to force flash loader,” 
quickly press a key. 

6. When you successfully activate the flash loader, you should 
see the following message in the terminal window: 

waiting for floader connection 
console now disabled 

If you didn’t press a key quickly enough, cycle power to the 
emulator, and try it again. 

7. Once you see the message that the emulator is waiting for 
the floader connection, exit the terminal emulation program 
and disconnect from the emulator. 

When the core loader is activated both LEDs on the Super¬ 
TAP flash rapidly. Be sure to leave the SuperTAP power on. 


SuperTAP 8XX 


D-3 

















Part 3: Program the emulator’s firmware 

Once you’ve activated the core loader, you can run the 
FLOADER utility that is included with MWX-ICE. 

>■ To run the FLOADER utility 

1. Using Windows Explorer, change directories to: 
install_drive: \insfcaII_dir\UTILS 

The default is C: \ST8XX\UTILS. 

2. Start the FLOADER.EXE utiUty. 

3. Choose Settings from the Edit menu. 

4. In the Communications Settings dialog box, select the 
commimications port the emulator is connected to, and 
select the fastest baud rate that your PC can handle, and 
then chck OK 

5. Choose Open from the File menu to open the flash file: 
CORE_PKG.LDR 

Information about the loader file is displayed in the main 
window. 

6. From the File menu, choose Download. 

The SupeiTAP automatically configures itself to the baud 
rate selected. This should only take a moment or two. If the 
autobaud is imsuccessful, try using a slower baud rate. 

FLOADER reports on the progress of the download. When 
the process is complete, you should see the message: File 
Successfully downloaded. 

7. Press the reset button. 

The upgrade is complete. You can exit FLOADER.EXE and re¬ 
connect the Ethernet cable to the SuperTAP. 
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Part 4: Remove outdated shells and pointers 

Before you start MWX-ICE 

Before you start MWX-ICE for the first time after 
reprogramming the emulator’s firmware, be sure you remove 
any old shell files (*.EP) or EMULCFG.DAT files that point to 
earlier shell files. To load the latest shell file when you connect 
to the emulator, select the Force OS Download option in the 
Connections dialog box. 

What’S next? 

Once you have completed the upgrade, return to the MWX-ICE 
startup procedures in Chapter 2. 
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BREAKWRITE 9-11,9-21 

BROWSE 9-22 

BTE 9-19 

Bus master 2-27 

Bus masters and overlay 3-4 

Buttons 10-7 


c 

Caches 

breakpoint system 6-11 
event system 7-25 
Cdemon 

dataO C-3 

detailed description C-1 
direct variable 10-77 
initialO C-2 
led^port C-3 
led_port variable 10-76 
loading 10-12 
outledO C-5 

primary data structures C-3 
runO C-5 
stepO C-2 
waitO C-5 
CEXPRESSION 9-22 
CLEAR 9-11 
Code accesses 7-25 
Code patching 10-27 
Command 

abasing 10-19 
history 10-19 
Commands 9-1 
supported 9-1 
unsupported 9-26 
Companion mode 

view/modify registers 8-10 
COMPARE 9-6 
Complex breakpoints 7-21 
CONCLEAR 9-25 
CONDELETE 9-25 
CONFIG 9-25 


Configuration 

emulator 2-11 
file A-4 
MWX-ICE 2-11 
restoring default A-6 
saving 2-11 
window 2-11 

Configuration registers 8-5 
Configuring flash 4-8 
CONLIST 9-25 
CONNECT 9-25 
Connecting to the emulator 2-10 
Connection commands 
CONCLEAR 9-25 
CONDELETE 9-25 
CONFIG 9-25 
CONLIST 9-25 
CONNECT 9-25 
CONSAVE 9-25 
DISCONNECT 9-25 
Connections 

emulator 2-10 
CONSAVE 9-25 
CONTEXT 9-22 
Conventions xix 
COPY 9-6 

Copying between target and overlay 3-16 
Copying memory 3-15 
Counters 7-18 
CPU Browser 

error checking 8-11 
CRC 9-6 
CTRn 9-15 
CTRnIVAL 9-15 
Customer Support xx 


D 

Data display in trace 5-24 
Debugger 

exiting 10-11 
installation xviii 
DEFINE 9-21 
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Defining 

emulator connections 2-9 
DELETE 9-22 
Demonstration code 

detailed description C-1 
loading 10-12 
DIAGO-8 9-20 
Diagnostic commands 
DIAGO-8 9-20 
Dialogs 10-7 
DIN 9-23 

Directory Chooser 10-8 
DISASSEMBLE 9-6, 9-17,10-27 
Disassembled trace 
capture 5-10 
common problems 5-32 
display 5-25 
DISCONNECT 9-25 
Display 9-17 
Display commands 

DISASSEMBLE 9-17 
DOWN 9-17 
DUMP 9-17 
EMUVARS 9-17 
EVTVARS 9-17 
EXPAND 9-7,9-17 
FOPEN 9-17 
FPRINTP 9-17 
HWCONFIG 9-17 
LIST 9-17 
MEMVARS 9-17 
MODE 9-18 
MONITOR 9-18 
NOMONITOR 9-18 
PRINTF 9-18 
PRINTSYMBOLS 9-18 
PMNTTYPE 9-18 
PRINTVALUE 9-18 
STATUS 9-18 
TGTMODE 9-18 
UP 9-18 
XICEVARS 9-18 
XLATE 9-18 
DNL 3-15,9-6 


DNL.GAP 9-7 
DNLFMT 9-6 
DOUT 9-23 
DOWN 9-17 

Downloading IEEE-695 files 3-15 
Downloading object code 3-15 
Downloads, stopping 3-16 
DRT 9-13 

DRTDATA 5-24,9-13 
DRTPULL 9-13 
DRTOPTn 5-23 
DRUN 1-4,9-11 
DSTOP 9-11 
DT 9-13 
DTB 5-25,9-13 
DTP 9-13 
DUMP 9-7,9-17 
DUPDATE 9-11 
DXINSERT 9-13 
DXLABELS 5-34,9-13 
DXMMU 5-30 
Dynamic mode 

monitoring variables, example 10-76 
Dynamic operations 1-4 
D}mamic run 1-4 
Dynamic trace 5-3, 5-4 

£ 

Embedded systems considerations 10-3 
Emulator 

connecting to 2-10 
definii^ a connection 2-9 
operational notes 2-24 
restoring defaults A-6 
updating D-1 

Emulator control commands 9-19 
BCLOCK 9-19 
BTE 9-19 
EMUVARS 9-19 
ISOMODE 9-19 
RESET 9-19 
RTE 9-19 
RUN_POLL 9-19 
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RUN.TIME 9-19 
SIT 9-19 
SITSTATE 9-19 
Emulator variables 9-19 
EMUVARS 9-17,9-19 
Environment variables 

XRAYMASTER 2-2, B-2 
EraseDevice 4-8, 9-7 
ERROR 9-7 
Event system 1-7, 7-1 
actions 7-9 
caches 7-25 
dear 7-14 
dealing 7-14 
commands 7-5 
counters 7-18 
display 7-13 
enable 7-14 
events 7-8 
features 7-2 
groups 7-15 
macros 7-21 
memoiy 7-20 
memory accesses 7-12 
qualifying trace 5-10 
realtime operation 7-23 
registers 7-20 
resources 7-26 
statements 7-8 
states 7-18 
structure 7-3 
syntax 7-7 
triggers 7-20 
valid statements 7-11 
Event system commands 9-15 
BEEAKCOMPLEX 9-15 
CTRn 9-15 
CTRnIVAL 9-15 
EVTVARS 9-15 
GROUP 9-15 
STATE 9-15 
WHEN 9-15 
WHENCLR 9-15 
WHENDISABLE 9-16 


WHENENABLE 9-16 
WHENLIST 9-16 
Event system tutorial 10-52 
EVTVARS 9-15,9-17 
Execution breakpoint 6-4,6-12 
Execution control 
BPTYPE 9-11 
BREAKACCESS 9-11 
BREAKCOMPLEX 9-11 
BREAKINSTRUCTION 9-11 
BREAKREAD 9-11 
BREAKWRITE 9-11 
CLEAR 9-11 
DRUN 9-11 
DSTOP 9-11 
DUPDATE 9-11 
GO 9-12 
GOSTEP 9-12 
PAUSE 9-12 
PORESET 9-12,9-19 
RESET 9-12 
RESTART 9-12 
SERIAL.CORE 9-12 
SIT 9-12 
SITSTATE 9-12 
STEP 9-12 
STEPOVER 9-12 
EXPAND 9-7,9-17,9-22 
Ei^ressions 9-22 
Exuded Tekhex 3-15 


F 

File Chooser 10-8 
File commands 9-6 
File formats 1-9 
FILL 9-7 
FIND 9-26 
Firmware 

updating D-1 
Flash memory 

configuring 4-8 
devices supported 4-11 
macros 4-14 
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programming target 4-1 
updating emulator D-1 
Flash programming 
macros 4-6 
Flashinc 4-6 
FOPEN 9-7,9-17 
Formats supported 1-9, 3-15 
FPRINTF 9-7,9-17 


G 

Getting help xvii 
GO 9-12 
GOSTEP 9-12 
GROUP 9-15 
Groups 

event sjrstem 7-15 


H 

Hardware installation xviii 
Help xvii 

command line 10-11 
stand-alone 9-2 
HISTORY 9-26 
HOST 9-26 
HWCONFIG 9-17 


/ 

yO simulation commands 9-23 
ICE 9-26 
Icons 10-7 
IEEE-695 3-15 
INCLUDE 3-9,9-7,9-21 
Include file A-9 
INITREGS 9-7 
command 8-7 
why needed 8-2 
Initregs 

.def file 8-5 
default file 8-5 
INPORT 9-23 


Installation 

hardware xviii 
software xviii 

Instruction breakpoint 6-4, 6-12,10-32 
setup 6-12 
Intel format 3-15 
Inteldevice 4-12, 9-8 
INTERRUPT 9-26 
Interrupt simulation 9-23 
Interrupts 1-5 
Interval timestamp 5-24 
Invocation 2-3 
IQFLS 5-31 
ir^s860.dat.ads 8-5 
ir^s860.dat.all 8-5 
iregs860.dat.amc 8-5 
iregs860.dat.def 8-5 
Isolation mode 2-19, 2-24 
ISOMODE 2-19,2-24,9-19 

J 

JOURNAL 5-3, 9-4 
Journal file A-10 


L 

LIST 9-8,9-17 
LOAD 3-15,9-8 
Loading code 3-15 
LockDevice 4-9, 4-10, 9-8 
LOG 5-3, 9-4 
Log file A-10 

Logical addressing 2-28, 5-30 
in displays 2-32 
Loss of power 2-19 
LSA 

use in the event system 7-7 


M 

Macro 

assigning to a breakpoint 6-6,10-50, 
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10-54 

creating 10-49 
deleting 10-51 
displajdng 10-50 
event system 7-21 
saving to a file 10-51 
Macro commands 

BREAKACCESS 9-21 
BREAKCOMPLEX 9-21 
BREAKINSTRUCTION 9-21 
BREAKREAD 9-21 
BREAKWRITE 9-21 
DEFINE 9-21 
INCLUDE 9-21 
SHOW 9-21 
VMACRO 9-21 
MAP 3-8, 9-8 
MAPCLR 3-8, 9-8 
MAPLIST 3-9,3-13,9-8 
Mapping overlay 10-29 
RAM 10-29 
ROM 10-29,10-30 
Mapping overlay memory 3-6 
Memory 

displaying and modifying, example 
event system 7-20 
flash programming macros 4-14 
prc^amming flash 4-1 
Memory access 

event systen 7-12 
Memory access type 
breakpoints 6-7 
Memory commands 9-6 
ADDRESS 9-6 
Amddevice 9-6 
ASM 9-6 
COMPARE 9-6 
COPY 9-6 
CRC 9-6 

DISASSEMBLE 9-6 
DNL 9-6 
DNL.GAP 9-7 
DUMP 9-7 
EraseDevice 9-7 


ERROR 9-7 
FILL 9-7 
FOPEN 9-7 
FPRINTF 9-7 
INCLUDE 9-7 
miTREGS 9-7 
Inteldevice 9-8 
LIST 9-8 
LOAD 9-8 
Lo<kDevice 9-8 
MAP 9-8 
MAPCLR 9-8 
MAPLIST 9-8 
MEMVARS 9-8 
OVERLAY 9-8 
OVREADTHRU 9-8 
OVWRITETHRU 9-8 
RELOAD 9-9 
RemoveDevice 9-9 
RESTART 9-9 
RESTORE 9-9 
RGVERIFY 9-9 
SAVE 9-9 
SETMEM 9-9 
10-74 SETREG 9-9 

SIZE 9-9 
TEST 9-9 
UPL 9-10 
UPLFMT 9-10 
VERIFY 9-10 
WHEN 9-10 
XLATE 9-10 
Memory control 

disassembling 10-27 
displaying 10-25 
moifying 10-26 
Memory examination 9-9 
MEMVARS 9-8,9-17 
Menus 10-7 
MMU 

in trace 5-30 
MMU support 2-28,3-12 
MODE 9-4,9-5,9-18 
MONITOR 9-18 
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Motorola ADS board 8-5 
MWX-ICE 

command listing 9-1 
initialization sequence 2-21 
startup 2-4 
startup options A-9 
startup reqmrements 2-3 

N 

NEXT 9-26 
No Target Vcc 2-24 
NOICE 9-26 
NOINTERRUPT 9-26 
NOMEMACCESS 9-26 
NOMONITOR 9-18 
Notebooks 10-8 
Notes on operation 2-24 

0 

Object fonnat 1-9 
Offset timestamp 5-24 
Online Help xvii 
Operational notes 2-24 
Operations during nm 1-4 
OPTION 9-4 
Options 

dd>ugger 10-16 
OUTPORT 9-23 
OVERLAY 3-16,3-18,9-8 
Overlay memory 1-5 

access qualification 3-7 
automatic adjustments 3-11 
bank addressing 3-6 
copying memory to 3-16 
cop 3 dng target memory 3-16 
copying target to overlay 3-15,10-30 
displaying 10-29 
do^^oading to 3-15 
errors and warnings 3-14 
external bus master 3-4 
features 3-3 


granularity 3-4 
limits 3-6 

listing and saving map 3-9 
logical addresses 3-7 
logical addressing 2-32 
logical addressing example 3-12 
mapping 3-6, 3-8, 3-11,10-29 
MMU initialization 3-12 
replacing ROM 3-2 
required termination 3-3 
restoring mappings 3-9 
returning to target 3-8 
sizes available 3-3 
specifying access source 3-18 
speed 3-3 

standard example 3-10 
summary of procedures 3-7 
theory of operations 3-6 
topics in help 3-1 
translation tables and 3-12 
typical uses 3-2 

Overlay..endpoints adjusted 3-14 
OVREADTHRU 3-4, 9-8 
OVWRITETHRU 3-4, 9-8 

p 

Patching code 10-27 
PAUSE 9-12,9-23 
Pause mode 

definition 10-10 
Peeks/Pokes 
tracing 5-9 
Phone support xx 
Physical address 5-30 
PORESET 9-12,9-19 
Port I/O and interrupt commands 
DIN 9-23 
DOUT 9-23 
INPORT 9-23 
OUTPORT 9-23 
PAUSE 9-23 
RIN 9-23 
ROUT 9-23 
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Port I/O simulation 9-23 
Power loss, target 2-24 
Power-on 

control program initialization 2-21 
emulator initialization 2-20 
sequence 2-7 

tracing during target power-on 5-3 
PPT 2-25,9-13 
PRINTANALYSIS 9-26 
PRINTP 9-18 
PRINTPROFILE 9-26 
PRINTSYMBOLS 9-18,9-22 
PRINTTYPE 9-18,9-22 
PRINTVALUE 9-18,9-22 
PROFILE 9-26 
Pixigramming flash 4-1 
macros 4-6 


Q 

Qualifying trace 5-10 
QUICC registers 8-10 
QUIT 9-4 


R 

RAMACCESS 9-26 
Raw trace display 5-35 
Realtime operation 
event system 7-23 
Recording a debug session 10-18 
Register (CPU) 10-24 
Register support 1-6 
Rasters 

configuring 8-9 
event system 7-20 
initregs command 8-7 
setting 8-10 
view/modify 8-10 
RELOAD 9-9 
RemoveDevice 4-11, 9-9 
RESET 2-21, 2-22, 9-12, 9-19 


Reset 

button 2-22 
emulator 2-22 
hardware 2-22 
software 2-21 
tracing during reset 5-3 
Resources 

access breakpoints 6-11 
breakpoints and event system 6-2 
event S 3 rstem 7-26 
instruction breakpoints 6-17 
RESTART 2-22,9-9,9-12 
RESTORE 9-9 
RGVERIFY 9-9 
RIN 9-23 

ROM, replacing with overlay 3-2 
ROMACCESS 9-26 
ROUT 9-23 
RTE 9-19 
RUN^POLL 9-19 
RUN_TIME 9-19 


s 

SAVE 9-9 

Saving configuration 2-11 
SCOPE 9-22 
Scope 10-20 
Scope Loops 10-55 
Scrolling windows 10-6 
SERIAL.CORE 9-12 
Session control 9-4 
JOURNAL 9-4 
LOG 9-4 
MODE 9-4 
OPTION 9-4 
QUIT 9-4 

SETSTATUSDIR 9-4 
SETSTATUS ENVIRONMENT 9-4 
SETMEM 9-9 
SETREG 8-10,8-11,9-9 
SETSTATUSDIR 9-4 
SETSTATUS ENVIRONMENT 9-4 
SETSTATUS EVENT 9-26 
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SETSTATUS QUALIFY 9-26 
SETSTATUS READ 9-26 
SETSTATUS TRACE 9-26 
SETSTATUS TRIGGER 9-26 
SETSTATUS VERIFY 9-26 
SETSTATUS WRITE 9-26 
SHOW 9-21 
Show (^des 6-11 
SHOWmST 9-13 
SIGA_MUX 7-7,9-13,9-15 
SIGB.MUX 7-7,9-13,9-15 
Signal timing 2-26 
Simulating 
i/o 9-23 
interrupts 9-23 
Single line assembler 10-27 
Single-stepping 2-26, 9-12 
SIT 9-12,9-19 
SIT mode 1-5 
SITSTATE 9-12,9-19 
SIZE 9-9 
Softswitches 9-19 
Software breakpoint 6-4, 6-12 
Software installation xviii 
SREC format 3-15 
Starting 

emulator and target 2-7 
MWX-ICE 2-3 
target code 2-22 
STARTUP 9-27 
Startup 

file,creating 2-11 
optiois A-9 
requirements 2-3 
Startup include file A-4 
startup.inc A-4 
STATE 9-15 
States 

event system 7-18 
STATUS 9-18,9-24 
Status 

bus master 2-27 
STATUS BUFFER 9-27 
Status commands 9-17 


STATUS EVENT 9-27 
STATUS QUALIFY 9-27 
STATUS TRACE 9-27 
STATUS TRIGGER 9-27 
STEP 9-12 
STEPOVER 9-12 
Stop-in-target mode 1-5 
Structures 

displaying, example 10-70 
SuperTAP 

configuration information 10-15 
SuperTAP Flash ROM 
updating D-1 
Support XX 
Symbol commands 
ADD 9-22 
BROWSE 9-22 
CEXPRESSION 9-22 
CONTEXT 9-22 
DELETE 9-22 
EXPAND 9-22 
PRINTSYMBOLS 9-22 
PRINTTYPE 9-22 
PRINTVALUE 9-22 
SCOPE 9-22 
Symbols in trace 5-34 

T 

TA/TEA 3-3 

Target isolation mode 2-19, 2-24 
Target Vcc Not Found 2-19, 2-24 
Technical support xx 
Temporary breakpoints 6-14 
Termination in overlay 3-3 
TEST 9-9 
Test target 8-5 
Text fields 10-7 
TGTMODE 9-18 
TIMCLK 5-25,9-14 
Timestamp 5-3, 5-24 
Timing 5-3 
Timing, AC signal 2-26 
TRACE 5-8,9-14 
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Trace 1-7 

assembly instruction in 5-33 
C source in 5-33 
capturing 10-42 
clearing 10-42 
clearing at run 5-8 
compression 5-31 
configuring 5-8-?? 
continuous raw 5-8, 5-22 
data display 5-24 
disassembled 5-10, 5-25 
disassembling 10-45 
disassembly problems 5-32 
displaying ??-5-32,10-44 
dynamic 5-3, 5-4 
peek4>oke 5-9 
power-up cycles 5-3 
preventing overwriting 5-9 
qualified 5-3, 5-10 
raw field descriptions 5-35 
reset sequences 5-3 
saving to a file 5-3,10-46 
selecting display fields 5-23 
symbols 5-34 
timestamp 5-3 
using MMU 5-30 
view while running 5-3, 5-4 
view while running, example 10-67 
Trace commands 5-8-5-11, 5-25, 9-13 
DRT 9-13 

DRTDATA 5-22,5-24,9-13 
DRTPULL 5-22,9-13 
DRTOPTn 5-23 
DT 5-25,9-13 
DTB 9-13 
DTP 5-25,9-13 
DXINSERT 5-25,9-13 
DXLABELS 9-13 
DXMMU 5-25 
PPT 9-13 
SHOWINST 9-13 
SIGA_MUX 9-13,9-15 
SIGB.MUX 9-13,9-15 
TIMCLK 9-14 


TRACE 9-14 
TRBASE 9-14 
TRCEXT 9-14 
TRCINT 9-14 
TRCLR 9-14 
TRDISP 5-25,9-14 
TRFRAMES 9-14 
TRQUAL 9-14 
TRRUNCLR 9-14 
TRSYS 9-14 
TSRCH 9-14 
TSTAMP 9-14 
Trace compression 5-31 
Trace history 

clearing 10-65 
Translation tables 2-28,3-12 
TRBASE 5-25,9-14 
TRCEXT 9-14 
TRCINT 9-14 
TRCLR 9-14 
TRDISP 9-14 
TRFRAMES 9-14 
Triggers 

external 7-20 
TRINIT 5-8 
Troubleshooting B-1 
TRQUAL 5-8,9-14 
TiaiUNCLR 5-8,9-14 
TRSTAMP 5-25 
TRSYS 5-8,9-14 
TSRCH 9-14 
TSTAMP 9-14 
Tutorial 

MWX-ICE debu^er 10-1 


u 

UnlockDevice 4-10, 9-9 
Unsupported commands 9-26 
UP 9-18 
Updating 

firmware D-1 
UPL 3-17,9-10 
UPLFMT 9-10 
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Uploading object code 3-17 
Utility commands 
ALIAS 9-24 
STATUS 9-24 
XLATE 9-24 


V 

VACTIVE 9-5 
Variables 

dynamically monitoring, example 10-76 
Vcc 2-24 
VCLEAR 9-5 
VCLOSE 9-5 
VERIFY 9-10 
VFCNT 5-31 
VP MSG 5-31 
VMACRO 9-5,9-21 
VOPEN 9-5 
VSETC 9-5 


resources 7-26 
statements 7-8 
states 7-18 
structure 7-3 
syntax 7-7 
triggers 7-20 
valid statements 7-11 
WHENCLR 9-15 
WHENDISABLE 9-16 
WHENENABLE 9-16 
WHENLIST 9-16 
Window Control 
MODE 9-5 
Window control 9-5 
VACTIVE 9-5 
VCLEAR 9-5 
VCLOSE 9-5 
VMACRO 9-5 
VOPEN 9-5 
VSETC 9-5 
WWW XX 


w 

Warranty xx 
Watches window 

dynamically updating 10-76 
WHEN 9-10,9-15 
When/then 

actions 7-9 
clear 7-14 
clearing 7-14 
commands 7-5 
coimters 7-18 
display 7-13 
enable 7-14 
events 7-8 
features 7-2 
groups 7-15 
macros 7-21 
memory 7-20 
memory accesses 7-12 
realtime operation 7-23 
rasters 7-20 


X-Y-Z 

XICEVARS 9-18 
XLATE 9-10,9-18,9-24 
XRAY commands 9-1 
XRAYMASTER 2-2, B-2 
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The Master Index contains the indexes for the three manuals that make up the documen- 
tation for the SuperTAP emulator and MWX-ICE debugger. The document set to which 
the manual belongs appears in parentheses following the page number reference. The 
following abbreviations are used: 

Abbr. Manual Title 

(RXRY) XRAY Debugger for Windows XRAY Reference Manual 

(UXRY) XRAY Debugger for Windows XRAY User*s Guide 

(XUM) MWXdCE Users Manual 


SuperTAP MPC8XXX System Integration 
Tool 


Symtiols 

% fline continuation) 6-4(RXRY) 

©(nesting) 4-13(RXRY) 

@ (path) 3-6(RXRY) 

©(root) 4-10(RXRY) 

© (symbol) 

nesting 4-13(RXRY) 
path 3-6(RXRY) 
root 4-10(RXRY) 

©addr pseudo-raster A-l(SXRY), 
B-KSXRY), B-4(SXRY) 

©as pseudo-register A-l(SXRY), B-l(SXRY) 
©chip pseudo-register A-l(SXRY), B-l(SXRY) 
©cycles pseudo-register A-l(SXRY), 
B-1(SXRY) 

©entry pseudo-register A-l(SXRY), 
B-KSXRY) 

©exc pseudo-raster A-l(SXRY), B-2(SXRY) 
©file pseudo-register A-l(SXRY), B-2(SXRY) 
©ft>f pseudo-raster A-l(SXRY), B-2(SXRY) 
©§)u pseudo-register A-l(SXRY), B-2(SXRY), 
B-5(SXRY), B-10(SXRY) 

©hlpc pseudo-register 4-ll(RXRY), 
A-KSXRY), B-3(SXRY) 

©line__range pseudo-register A-l(SXRY), 
B-3(SXRY) 


©module pseudo-register 4-ll(RXRY), 
A-KSXRY), B-3(SXRY) 

©pi pseudo-register A-l(SXRY), B-3(SXRY) 
^isize pseudo-raster A-l(SXRY), 
B-3(SXRY) 

(^ort_addr pseudo-register A-l(SXRY), 
B-3(SXRY) 

@port_size pseudo-register A-l(SXRY), 
B-3(SXRY) 

@port_value pseudo-register A-2(SXRY), 
B-4(SXRY) 

©procedure pseudo-register 4-ll(RXRY), 
A-2(SXRY), B-4(SXRY) 

©root pseudo-register 4-10(RXRY), 
A-2(SXRY), B-4(SXRY) 

@wait_state pseudo-register A-2(SXRY), 
B-4(SXRY) 


Numerics 

68030 support B-9(SXRY) 
68040 support B-IO(SXRY) 
68881 support B-ll(SXRY) 
68EC030 support B-IO(SXRY) 
68EC040 support B-ll(SXRY) 
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A 

About Box 1-15(UXRY)-1-16(UXRY) 
in File Editor 7-2(UXRY) 

About menu 

File Editor 7-2(UXRY) 

Absolute files, errors 3-7(RXRY) 

Absolute object module 
loading A-9(XUM) 

Absolute timestamp 5-24(XUM) 

AC signal timing 2-26(XUM) 

Access breakpoints 6-3(XUM) 
setting 6-7(XUM) 

ADD 9-22(XUM) 

Adding tools to a project 5-9(UXRY)- 
5-10(UXRY) 

@addr pseudo-register A-l(SXRY), 
B-l(SXRY) 

ADDRESS 2-28(XUM), 9-6(XUM) 

Address (definition) 6-2(RXRY) 

Address alignment 7-25(XUM) 

Address translation 2-28(XUM) 
Address_range (definition) 6-2(RXRY) 
Addresses 

line numbers 4-2(RXRY) 

Advanced feature commands 
performance profiling 

PRINTPROFILE 6-14(RXRY) 
PROFILE 6.14(RXRY) 
test coverage analysis 

ANALYZE 6-14(RXRY) 
PRINTANALYSIS 6-14(RXRY) 
trace 

SETSTATUS EVENT 6-14(RXRY) 
SETSTATUS QUALIFY 6-14(RXRY) 
SETSTATUS TRACE 6-14(RXRY) 
SETSTATUS 

TRIGGER 6-14(RXRY) 
STATUS BUFFER 6-14(RXRY) 


STATUS EVENT 6-14(RXRY) 
STATUS QUALIFY 6-14(RXRY) 
STATUS TRACE 6-14(RXRY) 
STATUS TRIGGER 6-15(RXRY) 
TRACE 6-15(RXRY) 

ALIAS 9-24(XUM) 

Alias page (Symbol Management 
notebook) 6-ll(RXRY) 

Alignment 

instructions B-4(SXRY) 

Alternate registers 

how set up 8-4(XUM) 

Amddevice 4-12(XUM), 9-6(XUM) 
ANALYZE 9-26(XUM) 

Annotate command (help) 4-8(UXRY)- 
4-9(UXRY) 

Annotating help items 4-8(UXRY)- 
4-9(UXRY) 

Applied Microsystems 
test target 8-5(XUM) 

Arrow keys in File Editor 7-5(UXRY) 

@as pseudo-register A-1(SXRY), B-l(SXRY) 
ASM 9-6(XUM) 

Assembler 

related documents P-3(UXRY) 
Assembly-level mode debugging 2-l(RXRY), 
2-7(RXRY) 


B 

Back button 

help 4-2(UXRY),4-5(UXRY),4-6(UXRY) 
Backspace key in File Editor 7-6(UXRY) 
Base directory for XRAY 

MasterWorks 2-4(UXRY) 

Basic breakpoints 6-l(XUM) 

Batch commands 3-4(RXRY) 

Batch mode support 3-4(RXRY) 


Abbr. 

(RXRY) XRAY Debugger for Windows 

(UXRY) XRAY Debugger for Windows 

(XUM) 


Manna] Title 
XRAY Reference Manual 
XRAY User's Guide 
MWX-ICE User's Manual 
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BCLOCK 9-19(XUM) 

Bookmark menu (help) 4-2(UXRY), 
4-7(UXRY)-4-8(UXRY) 

Bookmarks (help) 4-7(UXRY)—4-8(UXRY) 
BPTYPE 9-ll(XUM) 

Break 6-l(XUM) 

action 7-23(XUM) 
latency 7-23(XUM) 

Break page (Execution Control 

notebook) 6-6(RXRY), 6-12(RXRY) 
BREAK statement in macros 6-4(RXRY) 
BREAKACCESS 9-ll(XUM), 9-21(XUM) 
BREAKCOMPLEX 9-ll(XUM), 9-15(XUM), 
9-21(XUM) 

BreakI button 6-6(RXRY) 

Breaking em\ilation 6-l(XUM) 
BREAKINSTRUCTION 9.11(XUM), 
9-21(XUM) 

Breakpoints 1-7(XUM), 7-l(XUM), 
3^(RXRY) 

access 6-3(XUM), 6-7(XUM) 
access,process 6-10(XUM) 
assigning macros 6-6(XUM) 
associating with macro 6-2(RXRY) 
BPTYPE 9.11(XUM) 

BREAKACCESS 9-ll(XUM) 
BREAKCOMPLEX 9.11(XUM) 
BREAKINSTRUCTION 9.11(XUM) 
BREAKREAD 9-ll(XUM) 
BREAKWRITE 9-ll(XUM) 
caches 6-ll(XUM) 

CLEAR 9-ll(XUM) 
clearing 6-6(XUM) 
commands 6-5(XUM) 
displaying 6-6(XUM) 
execution 6-4(XUM), 6-12(XUM) 
features 6-l(XUM) 
instruction 6-4(XUM), 6-12(XUM), 
B-7(SXRY) 

instruction,process 6-16(XUM) 
instruction,setup 6-12(XUM) 
latency 6-10(XUM) 
memory access 6-8(XUM), 6-14(XUM) 
memory access type 6-7(XUM) 
recursive functions 4-13(RXRY) 


resources 6-ll(XUM), 6-17(XUM) 
setting BREAKACCESS 6-8(XUM) 
setting 

BREAKINSTRUCTION 6.14(X 
UM) 

setting BREAKREAD 6-8(XUM) 
setting BREAKWRITE 6-8(XUM) 
show cycles 6-ll(XUM) 

STEPOVER 9-12(XUM) 
temporary 6-14(XUM), 3-3(RXRY) 
Breakpoints window 6-6(RXRY), 6-7(RXRY) 
BREAKREAD 9-ll(XUM), 9-21(XUM) 
BREAKWRITE 9-ll(XUM), 9-21(XUM) 
BROWSE 9-22(XUM) 

Browse button (Source Explorer) 7-10(UXRY) 
Browse buttons (help) 4-2(UXRY), 4-6(UXRY) 
Browse sequences 4-5(UXRY)-4-6(UXRY) 
BTE 9-19(XUM) 

Build button (XRAY Make) 7-9(UXRY) 
Building apphcations 1-17(UXRY) 
tools for 1-7(UXRY)-1-10(UXRY) 

Bus master 2-27(XUM) 

Bus masters and overlay 3-4(XUM) 

Button commands 
(see Buttons) 

Buttons 

BreakI 6-6(RXRY) 

Clear 6-6(RXRY) 

Defaults Editor 6-2(UXRY>-6-3(UXRY) 
definition 3-12(UXRY) 

Down 6-ll(RXRY) 
figure 3-7(UXRY) 

Go 6-6(RXRY) 
help 4-2(UXRY) 

Back 4-2(UXRY), 4-5(UXRY), 
4.6(UXRY) 

Browse 4-2(UXRY), 4-6(UXRY) 
Contents 4-2(UXRY), 4-4(UXRY)- 
4-5(UXRY) 

Search 4-2(UXRY), 4-6(UXRY>- 
4.7(UXRY) 

Inspect 6-7(RXRY) 
parameters 3-7(UXRY) 

Print 6-8(RXRY) 

RecaU 6-ll(RXRY) 
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Scope 6-10(RXRY) 
Source Explorer 

Browse 7-10(UXRY) 
Stepinstr 6-7(KXRY) 
StepLine 6-7(RXRY) 
StepOver 6-7(RXRY) 

Up 6-12(RXRY) 
using 3-7(UXRY) 
XRAYMake 

Build 7.9(UXRY) 
Error 7-9(UXRY) 


C compiler 

related documents P-3(UXRY) 

C++ compiler 

related documents P-2(UXRY) 

Caches 

breakpoint system 6-ll(XUM) 
event system 7-25(XUM) 

Cancel command in File Editor 7-5(UXRY) 
Cdemon 

dataO C-3(XUM) 

detailed description C-1(XUM) 

initialO C-2(XUM) 

led_port C-3(XUM) 

outledO C-5(XUM) 

primary data structures C-3(XUM) 

runO C-5(XUM) 

stepO C-2(XUM) 

waitO C-5(XUM) 

CEXPRESSION 9-22(XUM) 
CEXPRESSION command 3-9(RXRY), 
3-10(RXRY) 

Change Directory command (File 
Editor) 7^(UXRY) 

Changing a defaults file 6-2(UXRY)- 


6-8(UXRY) 

Changing directories in File 
Editor 7-3(UXRY) 

Changing projects 5-7(UXRY)-5-10(UXRY) 
Changing the target processor for a 
project 5-9(UXRY) 

Check boxes 3-8(UXRY) 
definition 3-12(UXRY) 
figure 3-8(UXRY) 

Read-Only (File Editor) 7-3(UXRY) 

@chip pseudo-register A-1(SXRY), B-l(SXRY) 
CLEAR 9-ll(XUM) 

Clear button 6-6(RXRY) 

Closing File Editor 7-4(UXRY>-7-5(UXRY) 
Closing the Defaults Editor 6-9(UXRY) 
Closing windows 3-4(UXRY)-3-5(UXRY) 
Code accesses 7-25(XUM) 

Code browser 

(see Source Explorer) 

Code window 6-6(RXRY), 6-7(RXRY), 

6-8(RXRY), 6-10(RXRY), 6-ll(RXRY), 
6.12(RXRY) 

Command files 

comments 6-3(RXRY) 

Command options 3-8(UXRY) 

Command window 6-7(RXRY), 6-8(RXRY), 
6-ll(RXRY), 6-13(RXRY) 

Commands 9-l(XUM) 
supported 9-l(XUM) 
imsupported 9-26(XUM) 

Comments 

command files 6-3(RXRY) 
include files 6-3(RXRY) 
macros 6-3(RXRY) 

Common defaults 6-3(UXRY) 

Communication between tools 1-16(UXRY)- 
1-17(UXRY) 

File Editor and debugger 7-ll(UXRY)- 


Abbr. 

(RXRY) XRAY Debugger for Windows 

(UXRY) XRAY Debugger for Windows 

(XUM) 


Manual Titie 

XRAY Reference Manual 
XRAY User^s Guide 
MWX-ICE User's Manual 
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7-12(UXRY) 

File Editor and other tools 1-16(UXRY), 
7-9(UXRY)-7-12(UXRY) 

File Editor and Source 

Explorer 7-10(UXRY>- 
7-ll(UXRY) 

FileEditorandXRAYMake 1-16(UXRY), 
7-9(UXRY)~7-10(UXRY) 
prerequisite 5-4(UXRY) 

Source Explorer and 

debugger 1-17(UXRY) 

XRAY Make and debugger 1-17(UXRY) 
XRAY Make and Explorer 1-17(UXRY) 
Comp page (Memory Command 
notebook) 6-8(RXRY) 

Companion mode 

view/modify registers 8-10(XUM) 
COMPARE 9-6(XUM) 

Compiler 

related documents P-3(UXRY) 

Complex breakpoints 7-21(XUM) 
Components of XRAY MasterW orks 

(see XRAY MasterWorks, tools included) 
(see XRAY MasterWorks, tools) 
CONCLEAR 9-25(XUM) 

CONDELETE 9-25(XUM) 

CONFIG 9-25(XUM) 

Configuration 

emulator 2-ll(XUM) 
file A-4(XUM) 

MWXJCE 2-ll(XUM) 
restoring default A-6(XUM) 
saving 2-ll(XUM) 
window 2-ll(XUM) 

Configuration rasters 8-5(XUM) 
Configuring flash 4-8(XUM) 

Configuring XRAY MasterWorks 
tools 1^(UXRY)-1-7(UXRY) 

CONLIST 9-25(XUM) 

CONNECT 9-25(XUM) 

Connecting to the emulator 2-10(XUM) 
Connection commands 

CONCLEAR 9.25(XUM) 

CONDELETE 9-25(XUM) 

CONFIG 9-25(XUM) 


CONLIST 9.25(XUM) 

CONNECT 9.25(XUM) 

CONSAVE 9-25(XUM) 

DISCONNECT 9.25(XUM) 

Connections 

emulator 2-10(XUM) 

CONSAVE 9-25(XUM) 

Constant (definition) 6-2(RXRY) 

Contents button 

help 4-2(UXRY), 4-4(UXRY)-4-5(UXRY) 
Contents item 4-4(UXRY)-4-5(UXRY) 
CONTEXT 9-22(XUM) 

Continuation character (%) 6-4(RXRY) 
CONTINUE statement in macros 6-4(RXRY) 
Control Panel 1-2(UXRY), 1-3(UXRY), 

5-l(UXRY)-5-7(UXRY), 1.2(RXRY) 
creating projects 5-5(UXRY)-5-6(UXRY) 
Delete command 5-9(UXRY), 

5-10(UXRY) 

differences between two types 5-3(UXRY) 
Duplicate command 5-5(UXRY), 
5.6(UXRY), 5-9(UXRY) 

Edit command 5-7(UXRY), 5-9(UXRY) 
File menu 5-5(UXRY), 5-6(UXRY) 
files 5-ll(UXRY) 

Load command 5-6(UXRY) 
modes 1-5(UXRY), 5-2(UXRY) 
modifying projects 5-7(UXRY)- 
5-10(UXRY) 

New command 5-5(UXRY), 5-7(UXRY) 
notebook 1-13(UXRY), 5-7(UXRY>- 
5-8(UXRY), 5-9(UXRY>- 
5-10(UXRY) 

Open command 5-6(UXRY) 
opening projects 5-6(UXRY) 
overview 1-4(UXRY>-1-5(UXRY) 
project 5-l(UXRY), 5-2(UXRY>- 
5-3(UXRY) 

adding/deleting tools 5-9(UXRY)- 
5-10(UXRY) 

creating 5-5(UXRY)-5-6(UXRY) 
default 5-8(UXRY) 
definition 1-5(UXRY) 
deleting 5-10(UXRY) 
modifying 5-7(UXRY)-5-10(UXRY) 
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opening 5-6(UXRY) 

Project menu 5-5(UXRY), 5-6(UXRY), 
5-7(UXRY), 5-9(UXRY), 
5-10(UXRY) 

Rename command 5-7(UXRY), 
5.9(UXRY) 

XRAY MasterWorks 5-l(UXRY), 
5-l(UXRY)-.5-2(UXRY) 
definition 1-5(UXRY) 

Conventions xix(XUM) 

Conventions, notational P-4(UXRY), 
P-3(RXRY) 
help 4-3(UXRY) 

COPY 9-6(XUM) 

Copy command (File Editor) 7-6(lJXRY) 

Copy command (help) 4-10(UXRY) 

Copy page (Memory Command 
notebook) 6-8(RXRY) 

Copying a help item 4-10(lJXRY) 

Copying between target and 
overlay 3-16(XUM) 

Copying memory 3-15(XUM) 

Copying text 3-ll(UXRY) 

Ffie Editor 7-6(UXRY) 

Coimters 7-18(XUM) 

CPU Browser 

error checking 8-ll(XUM) 

CPU simulation B-l(SXRY) 

68030 support B-9(SXRY) 

68851 instruction support B-ll(SXRY) 
68881 floating-point support B-ll(SXRY) 
BKPT instruction B-7(SXRY) 
CALLMandRTM 

instructions B-8(SXRY) 

CPU space references B-7(SXRY) 
cycle times B-5(SXRY) 

©cycles pseudo-register B-5(SXRY) 
@wait_state pseudo¬ 


register B-5(SXRY), 
B-6(SXRY) 

exception handling B-5(SXRY) 

©exc pseudo-register B-5(SXRY) 
instruction alignment B-4(SXRY) 
memory initialization B-6(SXRY) 
trace bits B-7(SXRY) 

CPU space and coprocessor 

communication B-7(SXRY) 

CPU32 support B-IO(SXRY) 

CRC 9-6(XUM) 

Create page (Symbol Management 

notebook) 6-10(RXRY), 6-7(RXRY) 
Creating projects 5-5(UXRY)-5-6(UXRY) 
CTRn 9-15(XUM) 

CTRnIVAL 9-15(XUM) 

Cursor 

moving in File Editor 7-5(UXRY) 
Customer Support xx(XUM) 

Cut command (File Editor) 7-6(UXRY) 
©cycles pseudo-register A-1(SXRY), 
B-l(SXRY) 

D 

Data display in trace 5-24(XUM) 

Data type conversion 4-7(RXRY) 

Data types 

(see Symbolic references, data types) 
Debugger 

(see XRAY Debugger) 

Edit menu 7-l(UXRY), 7-ll(UXRY) 

File Editor in 7-ll(UXRY)-7-12(UXRY) 
installation xviiiCXUM) 
notebooks 1-14(UXRY) 

macro page 7-12(UXRY) 
overview 1-11(UXRY)-1-12(UXRY) 
Simple Editor command 7-ll(UXRY) 


Abbr. Manual Title 

(RXRY) XRAY Debugger for Windows XRAY Reference Manual 

(UXRY) XRAY Debugger for Windows XRAY User's Guide 

(XUM) MWX-ICE User's Manual 


Master index-6 


MWX-ICE User's Manual (Windows) 




Source Explorer, communicating 
with 1.17(UXRY) 

XRAY Make, communicating 
with 1-17(UXRY) 

Debugger commands 

command file comments 6-3(RXRY) 
command syntax 6-l(RXRY) 

command parameters 6-2(RXRY) 
command qualifiers 6-l(RXRY) 
size qualifiers 6-2(RXRY) 
entering 6-l(RXRY) 

Debugger Defaults 6-7(UXRY) 

Debugger Files notebook 

Inclpage 6-ll(RXRY), 6-7aRXRY), 
6-9(KXRY) 

Journal page 6-ll(RXRY) 

List page 6-70RXRY) 

Load page 6-5(RXRY) 

Log page 6-ll(KXRY) 

Scope page 6-10(RXRY) 

Debugger macros 

comments 6-3(RXRY) 
conditional statements 
BREAK 6-4(RXRY) 

CONTINUE 6-4(RXRY) 
DO-WHILE 6.4(RXRY) 

FOR 6.4(RXRY) 

IF 6-6(RXRY) 

IF-ELSE 6-6(RXRY) 

RETURN 6-6(RXRY) 

WHILE 6-7(RXRY) 
kejnvords as names 6-10(RXRY) 
macro definition 6-7(RXRY) 
comments 6-3(RXRY) 
file 6-9(RXRY) 

INCLUDE command 6-9(RXRY) 
interactive 6-7(RXRY) 
local symbols 6-7(RXRY) 
macro body 6-3(RXRY) 
saving macros 6-9(RXRY) 
macro invocation 6-9(RXRY) 
properties 6-ll(RXRY) 
return values 6-10(RXRY) 
saving 6-9(RXRY) 
source patches 6-ll(RXRY) 


stop execution 6-10(RXRY) 
use with breakpoints 6-2(RXRY) 
Debugger Macros menu 

File Editor 7-2(UXRY), 7-12(UXRY) 
Debugging applications 1-17(UXRY) 
rebuilding 1-17(UXRY) 
tools for 1-10(UXRY>-1-12(UXRY) 
Debugging in assembly-level 

mode 2-l(RXRY), 2-7(RXRY) 
Debugging in high-level mode 2-2(RXRY), 
2-9(RXRY) 

C expressions and statements 2-2(RXRY) 
STEP command 2-8(RXRY) 

STEPOVER command 2-8(RXRY) 
Debugging in low-level mode 2-l(RXRY), 
2-7(RXRY) 

Default projects 6-8(UXRY) 
file 2.5(UXRY) 

Defaults Editor 1-2(UXRY), 1-3(UXRY), 

6-l(UXRY)-6.9(UXRY), 1-2(RXRY) 
buttons 6-2(UXRY)-6-3(UXRY) 
closing 6-9(UXRY) 
common defaults 6-3(UXRY) 
debugger defaults 6-7(UXRY) 
editing a file 6-2(UXRY>-6-8(UXRY) 

Exit command 6-9(UXRY) 

exiting 6-9(UXRY) 

file editor defaults 6-8(UXRY) 

File menu 6-2(UXRY), 6-8(UXRY), 
6-9(UXRY) 

notebooks 1-14(UXRY), 6-2(UXRY>- 
6-8(UXRY) 

Open command 6-2(UXRY) 
opening a file 6-2(UXRY) 
overview 1-5(UXRY)-1“6(UXRY) 
position defaults 6-5(UXRY) 

Save As command 6-9(UXRY) 

Save command 6-8(UXRY) 
saving a defaults file 6-8(UXRY) 

SCMI defaults 6-8(UXRY) 

Defaults files 2-5(UXRY), 6-l(UXRY) 
editing 6-2(UXRY)-6-8(UXRY) 
opening 6-2(UXRY) 
saving 6-8(UXRY) 

DEFINE 9-21(XUM) 
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Defining 

emulator connections 2-9(XUM) 
Definitions 

address 6-2(RXRY) 
address_range 6-2(RXRY) 
constant 6-2(RXRY) 
expression 6-2(RXRY) 
expression_range 6-3(RXRY) 
expression_string 6-3(RXRY) 
line_number 6-3(RXRY) 
port__address 6-3(RXRY) 
symbol 6-3(KXRY) 

DELETE 9-22(XUM) 

Delete command (Control Panel) 5-9(UXRY), 
5-10(UXRY) 

Delete key in File Editor 7-6(UXRY) 
Deleting projects 5-10(UXRY) 

Deleting text (File Editor) 7-6(UXRY) 
Deleting tools from a project 5-9(UXRY)- 
5-10(UXRY) 

Demonstration code 

detailed description C-1(XUM) 
Dereferenced variable 4-120RXRY) 

DIAGO-8 9.20(XUM) 

Diagnostic commands 
DIAGO-8 9-20(XUM) 

Dialog boxes 
(see Dialogs) 

Dialogs 3-8(UXRY>^-9(UXRY) 
definition 3-12(UXRY) 
figure 3-9(UXRY) 
keyword search (help) 4-7(UXRY) 
Routine Information (Source 

Explorer) 7-10(UXRY) 

DIN 9-23(XUM) 

Directories 

.hh 4-8(UXRY), 4-9(UXRY) 
base directory 2-4(UXRY) 


changing in File Editor 7-3(UXRY) 
home 2-4(UXRY) 

DISASSEMBLE 9-6(XUM), 9-17(XUM) 
Disassembled trace 

capture 5-10(XUM) 
common problems 5-32(XUM) 
display 5-25(XUM) 

DISCONNECT 9-25(XUM) 

Display 9-17(XUM) 

Display commands 6-7(RXRY) 

DISASSEMBLE 9.17(XUM), 6-7(RXRY) 
DOWN 9-17(XUM) 

DUMP 9-17(XUM),6-7(RXRY) 
EMUVARS 9-17(XUM) 

EVTVARS 9.17(XUM) 

EXPAND 9.7(XUM), 9.17(XUM), 
6-7(RXRY) 

FIND 6-7(RXRY) 

FOPEN 9-17(XUM), 6-7(RXRY) 
FPRINTF 9-17(XUM), 6-7(RXRY) 
HWCONFIG 9.17(XUM) 

LIST 9-17(XUM), 6-7(RXRY) 
MEMVARS 9-170aJM) 

MODE 9-18(XUM) 

MONITOR 9.18(XUM) 

NEXT 6-8(RXRY) 

NOMONITOR 9-18(XUM) 

PRINTF 9-18(XUM), 6-8(RXRY) 
PRINTSYMBOLS 9-18(XUM) 
PRINTTYPE 9-18(XUM) 

PRINTVALUE 9-18(XUM), 6.8(RXRY) 
STATUS 9-18(XUM) 

TGTMODE 9-18(XUM) 

UP 9-18(XUM) 

XICEVARS 9-18(XUM) 

XLATE 9-18(XUM) 

Displaying status (File Editor) 7-9(UXRY) 
DNL 3-15(XUM), 9-6(XUM) 


Abbr. 

(RXRY) XRAY Debugger for Windows 

(UXRY) XRAY Debugger for Windows 

(XUM) 


Manual Title 
XRAY Reference Manual 
XRAY User^s Guide 
MWX-ICE User's Manual 
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DNL.GAP 9-7(XUM) 

DNLPMT 9-60CUM) 

Documents 

XRAYMasterWorks Master P-2(UXRY) 
Dotted underlines in help 4-5(UXRY) 

DOUT 9-23(XUM) 

DO-WHILE statement in macros 6-4(RXRY) 
DOWN 9-17(XUM) 

Down button 6-ll(RXRY) 

Downloading IEEE-695 files 3-15CSCUM) 
Downloading object code 3-15(XUM) 
Downloads, stopping 3-16(XUM) 

DRT 9-13CaJM) 

DRTDATA 5-24(XUM), 9-13(XUM) 
DRTFULL 9-13(XUM) 

DRTOPTn 5-23(XUM) 

DRLIN 1-4(XUM), 9-ll(XUM) 

DSTOP 9-ll(XUM) 

DT 9-13(XUM) 

DTB 5-25(XUM), 9-13(XUM) 

DTP 9-13(XUM) 

DUMP 9-7(3aJM), 9-17(XUM) 

DUMP command 

size qualifiers 6-2(RXRY) 

DUPDATE 9-ll(XUM) 

Duplicate command (Control 

Panel) 5-5(UXRY), 5-6(UXRY), 
5-9(UXRY) 

DXINSERT 9-13(XUM) 

DXLABELS 5-34(XUM), 9-13(XUM) 
DXMMU 5-30(XUM) 

Dynamic operations 1-4(XUM) 

Dynamic run 1-4(XUM) 

Dynamic trace 5-3(XUM), 5-4(XUM) 


E 

Echo include files 

INCECHO option 3-8(RXRY) 

Echo macros 

INCECHO option 3-8(RXRY) 

Edit command (Control Panel) 5-7(UXRY), 
5-9(UXRY) 


Edit menu 

debugger 7-l(UXRY), 7-ll(UXRY) 

File Editor 7-2(UXRY), 7-4(UXRY), 
7-5(UXRY), 7-6(UXRY), 
7-7(UXRY) 

help 4-2(UXRY), 4-8(UXRY)- 
4-9(UXRY), 4-10(UXRY) 
EDIT_CMD environment 

variable 1-8(UXRY), 7-4(UXRY) 
Editing a defaults file 6-2(UXRY)-6-8(UXRY) 
Editing a project 5-7(UXRY)—5-10(UXRY) 
Editing files 7-3(UXRY)-7-12(UXRY) 

Editor 

(see File Editor) 

EDITOR environment variable 1-8(UXRY), 
7-4(UXRY) 

Empty command (Pile Editor) 7-6(UXRY) 
Emulator 

connecting to 2-10(XUM) 
defining a coimection 2-9(XUM) 
operational notes 2-24(XUM) 
restoring defaults A-6(XUM) 
updating D-1(XUM) 

Emulator control commands 9-19(XUM) 
BCLOCK 9-19(XUM) 

BTE 9-19(XUM) 

EMUVARS 9-19(XUM) 

ISOMODE 9-19(XUM) 

RESET 9-19(XUM) 

RTE 9-19(XUM) 

RUN.POLL 9-19(XUM) 

RUN.TIME 9-19(XUM) 

SIT 9-19(XUM) 

SITSTATE 9-19(3CUM) 

Emulator variables 9-19(XIJM) 

EMUVARS 9-17(XUM), 9-19GCUM) 

Entering text 3-ll(UXRY) 

©entry pseudo-register A-l(SXRY), 
B-KSXRY) 

Environment variable 

XRAYMASTER 6-2(UXRY) 

Enviroiunent variables 2-l(UXRY)- 
2-5(UXRY) 

EDIT_CMD 1-8(UXRY), 7-4(UXRY) 
EDITOR 1-8(UXRY), 7-4(UXRY) 
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LD_LIBRARY_PATH 2-2(UXRY), 
2-5(UXRY) 

USR.MRI 2-2(UXRY), 2-4(UXRY), 
6-2(UXRY), 3-6(RXRY) 
VISUAL 1.8(UXRY), 7^(UXRY) 
XRAY 2-2(UXRY), 3-6(RXRY) 
XRAYMASTER 2-2(XUM), B.2(XUM), 
2-l(UXRY), 2-4(UXRY) 
XRAYMASTER_HOME 2-2(UXRY), 
6-2(UXRY) 

XRAYMASTER_TMP 2-2(UXRY), 
2-4(UXRY) 

EraseDevice 4-8(XUM), 9-7(XUM) 

Erasing projects 5-10(UXRY) 

Erasing text (File Editor) 7-6(UXRY) 
ERROR 9.7(XUM) 

Error button (XRAY Make) 7-9(UXRY) 
Errors reading absolute files 3-7(RXRY) 
Errors, locating 1-16(UXRY), 7-9(UXRY>- 
7-12(UXRY) 

Event system 1-7(XUM), 7-l(XUM) 
actions 7-9(XUM) 
caches 7-25(XUM) 
dear 7-14(XUM) 
dealing 7-14(XUM) 
commands 7-5(XUM) 
counters 7-18(XUM) 
display 7-13(XUM) 
enable 7-14(XUM) 
events 7-8(XUM) 
features 7-2(XUM) 
groups 7-15(XUM) 
macros 7-21(XUM) 
memory 7-20(XUM) 
memory accesses 7-12(XUM) 
qualifying trace 5-10(XUM) 
realtime operation 7-23(XUM) 
registers 7-20(XUM) 


resources 7-26(XUM) 
statements 7-8(XUM) 
states 7-18(XUM) 
structure 7-3(XUM) 
syntax 7-7(XUM) 
triggers 7-20(XUM) 
valid statements 7-ll(XUM) 

Event system commands 9-15(XUM) 
BREAKCOMPLEX 945(XUM) 

CTRn 9-15(XUM) 

CTRnIVAL 9-15(XUM) 

EVTVARS 9-15(XUM) 

GROUP 9-15(XUM) 

STATE 9.15(XUM) 

WHEN 9.15(XUM) 

WHENCLR 9.15(XUM) 
WHENDISABLE 9-16(XUM) 
WHENENABLE 9-16(XUM) 
WHENLIST 9.16(XUM) 

EVTVARS 9.15(XUM), 9.17(XUM) 

@exc pseudo-register A-1(SXRY), B-2(SXRY) 
Exception handling B-2(SXRY), B-5(SXRY) 
Executing multiple commands 3-4(RXRY) 
Execution and breakpoint 

commands 6-6(RXRY) 
BREAKACCESS 6-6(RXRY) 
BREAKINSTRUCTION 6-6(RXRY) 
BREAKREAD 6-6(RXRY) 
BREAKWRITE 6-6(RXRY) 

CLEAR 6.6(RXRY) 

GO 6-6(RXRY) 

(X)STEP 6-6(RXRY) 

STEP 6-7(RXRY) 

STEPOVER 6-7(RXRY) 

Execution breakpoint 6-4(XUM), 6-12(XUM) 
Execution control 

BPTYPE 9-ll(XUM) 

BREAKACCESS 9-ll(XUM) 


Ahhr. 

(RXRY) XRAY Debugger for Windows 

(UXRY) XRAY Debugger for Windows 

(XUM) 
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BREAKCOMPLEX 9-ll(XUM) 
BREAKINSTRUCTION 9-ll(XUM) 
BREAKREAD 9-ll(XUM) 
BREAKWRITE 9-ll(XUM) 

CLEAR 9-ll(XUM) 

DRUN 9-ll(XUM) 

DSTOP 9-ll(XUM) 

DUPDATE 9-ll(XUM) 

GO 9-12(XUM) 

GOSTEP 9-12(XUM) 

PAUSE 9.12(XUM) 

PORESET 9-12(XUM), 9-19(XUM) 
RESET 9-12(XUM) 

RESTART 9-12(XUM) 

SERIAL_CORE 9.12(XUM) 

SIT 9-12(XUM) 

SrrSTATE 9-12(XUM) 

STEP 9-12(XUM) 

STEPOVER 9-12(XUM) 

Execution Control notebook 6-10(RXRY) 
Break page 3-3(RXRY), 6-6(RXRY), 
6-12(RXRY) 

Go To page 6-6(RXRY) 

GoSteppage 6-6(RXRY), 6-ll(RXRY) 
Steppage 6-7(RXRY) 

Exit command (Defaults Editor) 6-9(UXRY) 
Exit command (File Editor) 7-4(UXRY) 

Exit Program command (File 
Editor) 7-4(UXRY) 

Exiting File Editor 7-4(UXRY)-7-5(UXRY) 
Exiting the Defaults Editor 6-9(UXRY) 
Exiting windows 3-4(UXRY)-^-5(UXRY) 
EXPAND 9-7(XUM), 9-17(XUM), 9-22(XUM) 
Explorer 

(see Source Explorer) 

Expression (definition) 6-2(RXRY) 
Expression elements 4-l(RXRY) 
addresses 4-l(RXRY) 

line numbers 4-2(RXRY) 
Expression_range (definition) 6-3(RXRY) 
Expression_string 

(definition) 6-3(RXRY) 

Expressions 9-22(XUM) 

assembly language 4-2(RXRY) 
expression string 4-3(RXRY) 


source language 4-2(RXRY) 
Extended Tekhex 3-15(XUM) 


F 

File commands 9-6(XUM) 

File Editor 1-2(UXRY), 1-3(UXRY), 

7.1(UXRY)^7.13(UXRY), 1-2(RXRY), 
6-8(RXRY) 

About menu 7-2(UXRY) 
cancel action 7-5(UXRY) 

Change Directory command 7-3(UXRY) 
closing 7-4(UXRY)-7-5(UXRY) 
copy 7-6(UXRY) 

Copy command 7-6(UXRY) 
cursor, moving 7-5(UXRY) 

Cut command 7-6(UXRY) 

Debugger Macros menu 7-2(UXRY), 
7-12(UXRY) 

deleting text 7-6(UXRY) 

Edit menu 7-2(UXRY), 7-4(UXRY), 
7-5(UXRY), 7.6(UXRY), 
7-7(UXRY) 

Empty command 7-6(UXRY) 
erasing text 7-6(UXRY) 

Exit command 7-4(UXRY) 

Exit Program command 7-4(UXRY) 

File field 7-3(UXRY) 

File menu 7-2(UXRY), 7-3(UXRY), 
7.4(UXRY), 7-5(UXRY), 
7-6(UXRY), 7-12(UXRY) 

Find and Replace command 7-8(UXRY) 
Find command 7-7(UXRY) 

Find fi*om Selection 

command 7-8(UXRY) 

Find menu 7.2(UXRY), 7-7(UXRY), 
7-8(UXRY) 

Find Next command 7-8(UXRY) 

Format command 7-6(UXRY), 
7.7(UXRY) 

formatting 7-6(UXRY)-7-7(UXRY) 

Help menu 7-2(UXRY) 

in debugger 7-ll(UXRY)-7-12(UXRY) 

in other tools 1-16(UXRY) 
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in Source Explorer 7-10(UXRY>- 
7-ll(UXRY) 

inXRAYMake 1-16(UXRY), 7-9(UXRY)- 
7-10(UXRY) 

Include command 7-6(UXRY) 

Insensitive Searches 

command 7-8(UXRY) 
inserting text 7-6(UXRY) 

Jump To Fxmction command 7-8(UXRY) 
Line field 7.3(UXRY), 7-5(UXRY) 

Locate menu 7-2(UXRY), 7-10(UXRY) 
menus 7-2(UXRY) 
mouse 7-5(UXRY), 7-6(UXRY) 
moving window 7-5(UXRY) 

New Editor Copy command 7-4(UXRY) 
New Editor Empty command 7-4(UXRY) 
Next Error command 7-10(UXRY) 

Open command 7-3(UXRY) 
opening a file 7-3(UXRY>-7-4(UXRY) 
overview 1-7(UXRY)-1-8(UXRY) 

Pair Matching command 7-8(UXRY) 
Paste command 7-6(UXRY) 

Personal Editor command 7-4(UXRY) 
Previous Error command 7-10(UXRY) 
Print command 7-4(UXRY) 
printing a file 7-4(UXRY) 
quitting 7-4(UXRY)-7-5(UXRY) 
Read-Only field 7-3(UXRY) 
removing text 7-6(UXRY) 

ReOpen command 7-5(UXRY) 

Save As command 7-4(UXRY) 

Save command 7-4(UXRY), 7-12(UXRY) 
saving a file 7-4(UXRY) 
search 7-7(UXRY)-7.8(UXRY) 

Search Backward command 7-7(UXRY) 
selecting text 7-6(UXRY) 

Send macro to Debugger 

command 7-12(UXRY) 


Show Insert Cursor command 7-5(UXRY) 
Show Last Changed Line 

command 7-5(UXRY) 
status line 7-3(UXRY) 

File 7-3(UXRY) 

Line 7-3(UXRY), 7-5(UXRY) 
Read-Only 7-3(UXRY) 
status, displaying 7-9(UXRY) 

Stop at top/bottom command 7-7(UXRY) 
typing text 7-6(UXRY) 

Undo command 7-5GJXRY) 
using 7-3(UXRY)-7-12(UXRY) 
using in other tools 7-9(UXRY)- 
7-12(UXRY) 

View menu 7-2(UXRY), 7-5(UXRY), 
7-9(UXRY) 

Where am I command 7-9(UXRY) 

File Editor Defaults 6-8(UXRY) 

File Editor in SCMI 7.12(UXRY) 

File field (File Editor status line) 7-3(UXRY) 
File formats 1-9(XUM) 

File menu 

Change Directory 6-12(RXRY) 

Control Panel 6-5(UXRY), 5-6(UXRY) 
Defaults Editor 6-2(UXR^, 6-8(UXRY), 

6- 9(UXRY) 

Exit Debugger 6-5(RXRY) 

File Editor 7-2(UXRY), 7-3(UXRY), 

7- 4(UXRY), 7.5(UXRY), 
7-6(UXRY), 7-12(UXRY) 

help 4-2(UXRY),4-9(UXRY), 

4-10(UXRY) 

Load 6-5(RXRY) 

Make and Load 6-5(RXRY) 

Reload 6-5(RXRY) 

Remake and Reload 6-5(RXRY) 

Restart 6-12(RXRY) 

Scope 6-10(RXRY) 
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pseudo-register A-l(SXRY), B-2(SXRY) 
Files 2-4(UXRY)-2-6(UXRY) 

.master.def 2-5(lJXRY), 6-2(UXKY) 
.Xdefaults 4-10(UXRY) 
absolute 3-7(RXRY) 
command 6-3(RXRY) 

Control Panel 5-ll(UXRY) 
default projects 2-6(UXRY) 
defaults 2-5(UXRY), 6-l(UXRY) 
editing 7-3(UXRY>-7-12(UXRY) 
help 2-5(UXRY),4-l(UXRY),4-8(UXRY), 
4-9(UXRY) 
include 3-4(RXRY) 
journal 3-4(RXRY) 
loading 3-7(KXRY) 
notebook definition (.dia) 2-5(UXRY) 
opening in File Editor 7-3(UXRY)- 
7-4(UXRY) 

printing in File Editor 7-4(UXRY) 
project 2-5(UXRY), 5-4(UXRY) 
deleting 5-10(UXRY) 
saving in File Editor 7-4(UXRY) 
semi layout 2-5(UXRY) 
set-up fQe 2-5(UXRY) 
source 3-6(RXRY) 
temporary 2-2(UXRY) 
tools.xcp 2-5(UXRY) 

FILL 9-7(XUM) 

FILL command 3-10(RXRY) 
size qualifiers 6-2(RXRY) 

Fill page (Memory Command 
notebook) 6-8(RXRY) 

FIND 9-26(XUM) 

Find and Replace command (File 
Editor) 7-8(UXRY) 

Find command (File Editor) 7-7(UXRY) 

Find fi-om Selection command (File 
Editor) 7-8(UXRY) 

Find menu 

File Editor 7-2(UXRY), 7-7(UXRY), 
7-8(UXRY) 

Find Next command (File Editor) 7-8(UXRY) 
Firmware 

updating D-1(XUM) 


Flash memory 

configuring 4-8(XUM) 
devices supported 4-ll(XUM) 
macros 4-14(XUM) 
programming target 4-l(XUM) 
updating emulator D-1(XUM) 

Flash programming 
macros 4-6(XUM) 

Flash.inc 4-6(XUM) 

Flexible License Manager 

related documents P-2(IJXRY) 

FOPEN 9-7(XUM), 9-17(XUM) 

FOR statement in macros 6-4(RXRY) 

Format command (File Editor) 7-6(UXRY), 
7-7(UXRY) 

Formats supported 1-9(XUM), 3-15(XUM) 
Formatting text (File Editor) 7-6(UXRY)- 
7-7(UXRY) 

@fpf pseudo-register A-l(SXRY), B-2(SXRY) 
FPRINTF 9-7(XUM), 9-17(XUM) 

FPRINTF command 3-9(RXRY) 

@fyu pseudo-register A-l(SXRY), B-2(SXRY) 
Functions, target 4-4(RXRY) 

G 

Getting help xvii(XUM) 

Global variables, referencing 4-5(RXRY) 
Glossary of user interface 

terms 3-12(UXRY)-3-13(UXRY) 

GO 9-12(XUM) 

Go button 6-6(RXRY) 

GO command 3-3(RXRY), 4-13(RXRY) 

Go To page (Execution Control 
notebook) 6-6(RXRY) 

GOSTEP 9-12(XUM) 

GOSTEP command 3-3(RXRY) 

(jioStep page (Execution Control 

notebook) 6-6(RXRY), 6-ll(RXRY) 
Graphical user interface 2-3(RXRY) 

(see also Notebooks) 

(see Interface) 

GROUP 9-15(XUM) 
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Groups 

event system 7-15(XUM) 


H 

Hardware installation xviii(XUM) 

Help xvii(XUM), 4.1(UXRY)-4.10(UXRY), 
3.1(RXRY) 

Annotate command 4-8(UXRY)- 
4-9(UXRY) 

Back button 4-2(UXRY), 4-5(UXRY), 
4-6(UXRY) 

Bookmark menu 4-2(UXRY), 
4-7(UXRY)-4-8(UXRY) 
bookmarks 4-7(UXRY>-4-8(UXRY) 
Browse buttons 4-2(UXRY), 4-6(UXRY) 
browse sequences 4-5(XJXRY)- 
4-6(UXRY) 
buttons 4-2(UXRY) 

Contents button 4-2(UXRY), 4-4(XJXRY)- 
4.5(UXRY) 

contents item 4-4(UXRY)-4-5(UXRY) 
Copy command 4-10(UXRY) 

Edit menu 4-2(UXRY), 4-8(UXRY>- 
4-9(UXRY), 4-10(UXRY) 

File menu 4-2(lJXRY), 4-9(UXRY), 
4-10(UXRY) 

mes 2-5(UXRY),4-l(UXRY),4-8(UXRY), 
4-9aJXRY) 

Help menu 4-2(UXRY), 4-5(UXRY) 
items 4-l(UXRY) 

cop3dng 4-10(UXRY) 
printing 4-9(UXRY)-4-10(UXRY) 
up 4-6(UXRY) 

keyword search dialog 4-7(UXRY) 
ke 5 rword searches 4-6(UXRY)-- 
4-7(UXRY) 

menu in File Editor 7-2(UXRY) 


menus 4-2(UXRY) 
moving in 4-4(UXRY)-4-8(UXRY) 
notational conventions 4-3(UXRY) 
notes 4-8(lJXRY)-4-9(UXRY) 
overview 1-14(UXRY)-1-15(UXRY) 
placeholders 4-7(UXRY)~4-8(UXRY) 
PrinterSetup command 4-10(lJXRY) 
PrintTopic command 4-9(UXRY)- 
4.10(UXRY) 

Search button 4-2(IJXRY), 4-6(UXRY)- 
4-7(UXRY) 

searching 4-6(UXRY)-4-7(UXRY) 

stand-alone 9-2(XUM) 

title line 4-6(UXRY) 

up item 4-6(UXRY) 

window 4-l(UXRY>-4-2(UXRY) 

HELP command 3-l(RXRY) 

Help facility 2-6(RXRY) 

Help file 3-6(RXRY) 
location 3-6flRXRY) 

Help items 4-l(UXRY) 
copying 4-10(UXRY) 
printing 4-9(UXRY)-4-10(UXRY) 

Help menu 

File Editor 7.2(UXRY) 
help 4-2(UXRY), 4-5(UXRY) 

High-level mode debugging 2-2(RXRY), 
2-9(RXRY) 

C expressions and statements 2-2(RXRY) 
STEP command 2-8(RXRY) 

STEPOVER command 2-8(RXRY) 
HISTORY 9-26(XUM) 

@hlpc pseudo-raster 4-ll(RXRY), 
A-1(SXRY),B-3(SXRY) 

Home directory for XRAY 

MasterWorks 2-4(UXRY) 

HOST 9-26(XUM) 

HWCONFIG 9-17(XUM) 
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H3^erlink 4-5(lJXRY) 


/ 

VO simulation commands 9-23(XlJM) 

I/O, simulated 3-5(RXRY) 

ICE 9-26(XUM) 

Iconifying windows 3-4(UXRY) 

Icons 

definition 3-12(UXRY) 
moving 3-3(UXRY) 
question mark 4-l(UXRY) 

IEEE-695 3.15(XUM) 

IF statement in macros 6-6(RXRY) 

IP-ELSE statement in macros 6-6(RXRY) 
In-drcuit debugger monitor 

related documents P-2(UXRY) 

In-drcuit emulator commands 6-13(RXRY) 
BREAKCOMPLEX 6-13(RXRY) 

ICE 6-13(RXRY) 

NOICE e-lSORXRY) 

Incl page (Debugger Files 

notebook) 6-ll(KXRY), 6-7(RXRY), 
6-9(RXRY) 

INCLUDE 3-9(XUM), 9-7(XUM), 9-21(XUM) 
INCLUDE command 3-4(RXRY) 

Include command (File Editor) 7-6(UXRY) 
Include file A-9(XUM) 

Include files 3-4(RXRY) 
comments 6-3(RXRY) 
no echo 

INCECHO option 3-8(RXRY) 

Info page (Symbol Management 
notebook) 6-10(RXRY) 

INITREGS 9-7(XUM) 
command 8-7(XUM) 
why needed 8-2(XUM) 

Initregs 

.def file 8-5(XUM) 
default file 8-5(XUM) 

INPORT 9-23(XUM) 

INPORT command 3-5(RXRY) 
size qualifiers 6-2(RXRY) 
inport macro 3-5(RXRY) 


Input page (Utility Commands 
notebook) 6-9(RXRY) 

Insensitive Searches command (File 
Editor) 7-8(UXRY) 

Inserting text (File Editor) 7-6(UXRY) 
Inspect button 6-7(RXRY) 

Inspector window 6-7(RXRY), 6-8(RXRY) 
Installation 

hardware xviii(XUM) 
software xviii(XUM) 

Instruction alignment B-4(SXRY) 

Instruction breakpoint 6-4(XUM), 6-12(XUM) 
setup 6-12(XUM) 

Intel format 3-15(XUM) 

Inteldevice 4-12(XUM), 9-8(XUM) 

Interface 1-13(UXRY)-1-15(UXRY), 
3-l(UXRY)-^-13(UXRY) 

(see Graphical User Interface) 
INTERRUPT 9-26(XUM) 

Interrupt simulation 9-23(XUM) 

Interrupts 1-5(XUM) 

Interval timestamp 5-24(XUM) 

Intrpt page (Utility Commands 
notebook) 6-9(RXRY) 

Invocation 2-3(XUM), 2-4(UXRY) 
requirements 2-l(UXRY) 

Invoking tools in XRAY 

MasterWorks 5-3(UXRY)~ 
5.4(UXRY) 

auto start 5-10(UXRY) 

10 Dis page (Utility Commands 
notebook) 6-9(RXRY) 

10 Rew page (Utihty Commands 
notebook) 6-10(RXRY) 

IQFLS 5-31(XUM) 
ir^s860.dat.ads 8-5(XUM) 
iregs860.dat.all 8-5(XUM) 
iregs860.dat.amc 8-5(XUM) 
iregs860.dat.def 8-5(XUM) 

Isolation mode 2-19(XUM), 2-24(XUM) 
ISOMODE 2-19(XUM),2-24(XUM), 
9-19(XUM) 

Items, help 4-l(UXRY) 
copying 4-10(UXRY) 
printing 4-9(UXRY)-4-10(UXRY) 
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up 4-6(UXRY) 


J 

JOURNAL 5-3(XUM), 9..4(XUM) 

JOURNAL command 3-4(RXRY) 

Journal file A-10(XUM), 3-4(RXRY) 

Journal page (Debugger Files 

notebook) 6-ll(RXRY) 

Jump h 3 rperlink 4-5(UXRY) 

Jump To Fimction command (File 
Editor) 7-8(UXRY) 

Jumping stack levels in execution 3-2(RXRY) 


K 

Keyboard shortcuts for menu 

commands 3-12(UXRY) 

Keys 

arrow (File Editor) 7-5(UXRY) 
backspace (File Editor) 7-6(UXRY) 
Delete (File Editor) 7-6(UXRY) 
Kejrword search dialog (help) 4-7(UXRY) 
Keyword searches in help 4-6(UXRY)- 
4-7(UXRY) 

L 

LD_LIBRARY_PATH environment 

variable 2-2(UXRY), 2-5(UXRY) 
L^al expressions 4-2(RXRY) 
examples 4-3(RXRY) 
expression strings 4-3(RXRY) 
Length of line 6-4(RXRY) 

Librarian 

related documents P-3(UXRY) 
Libraries, shared 2-2(UXRY), 2-5(UXRY) 


Library icon on notebooks 3-10(UXRY) 
Licensing 

related documents P-2(UXRY) 

Line continuation character (%) 6-4(RXRY) 
Line field (File Editor status line) 7-3(UXRY), 
7-5(UXRY) 

Line length 6-4(RXRY) 

Line numbers 4-2(RXRY) 

Line_number (definition) 6-3(RXRY) 
@line__range pseudo-register A-l(SXRY), 
B-3(SXRY) 

Linker 

related documents P-3(UXRY) 

LIST 9-8(XUM), 9-17(XUM) 

LIST command 3-l(RXRY) 

List page (Debugger Files 

notebook) 6-7(RXRY) 

LOAD 3-15(XUM), 9-8(XUM) 

LOAD command 

/A option 3-7(RXRY) 

/NS option 3-7(RXRY) 

Load command (Control Panel) 5-6(UXRY) 
Load page (Debugger Files 

notebook) 6-5(RXRY) 

Loading code 3-15(XUM) 

Loading files 3-7(RXRY) 
application 3-7(RXRY) 

ROM support routines 3-7(RXRY) 

Local symbols 

in macro definition 6-7(RXRY) 
referencing 4-5(RXRY) 
register 4-5(RXRY) 

Locate menu 

File Editor 7-2(UXRY), 7-10(UXRY) 
Locating errors 1-16(UXR10, 7-9(UXRY)- 
7.12(UXRY) 

LockDevice 4-9(XUM), 4-10(XUM), 9-8(XUM) 
LOG 5-3(XUM), 9-4(XUM) 
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Log file A-10(XUM) 

Log page (Debugger Files 

notebook) 6-ll(RXRY) 

Logging commands 3-4(RXRY) 

Logical addressing 2-28(XUM), 5-30(XUM) 
in displays 2-32(XUM) 

Loss of power 2-19(XUM) 

Low-level mode debugging 2-l(RXRY), 
2-7(RXRY) 

LSA 

use in the event system 7-7(XUM) 


M 

Macro 

assigning to a breakpoint 6-6(XUM) 
event system 7-21(XUM) 

Macro commands 6-12(RXRY) 
BREAKACCESS 9-21(XUM) 
BREAKCOMPLEX 9-2ia:UM) 
BREAKINSTRUCTION 9.21(XUM) 
BREAKREAD 9-21(XUM) 
BREAKWRITE 9.21(XUM) 

DEFINE 9-21(XIJM),6.12(RXRY) 
INCLUDE 9-21(XUM) 

MACRO 6-10(RXRY) 

SHOW 9-21(XUM), 6-12(RXRY) 
VMACRO 9-21(XUM) 
macro ke 3 rword 6-10(RXRY) 

Macro notebook page (debugger) 7-12(UXRY) 
Macro page (Symbol Management 

notebook) 6-12(RXRY), 6-7(RXRY), 
6-8(RXRY), 6.9(RXRY) 

Macros 2-5(RXRY) 
inport 3-5(RXRY) 
no echo 

INCECHO option 3-8(RXRY) 
outport 3-5(RXRY) 
until 3-3(RXRY) 
when 3-3(RXRY) 
make utility 1-8(UXRY) 

MAP 3-8(XUM), 9-8(XUM) 

Map page (Memory Command 

notebook) 6-8(RXRY), 6-9(RXRY) 


MAPCLR 3.8(XUM), 9-8(XUM) 

MAPLIST 3-9(XUM), 3-13(XUM), 9-8(XUM) 
Mapping overlay memory 3-6(XUM) 
.master.def file 2-5(UXRY), 6-2(UXRY) 
MasterWorks 

(see XRAY MasterWorks) 

Memory 

event system 7-20(XUM) 
flash programming macros 4-14(XUM) 
initialization B-6(SXRY) 
programming flash 4-l(XUM) 

Memory access 

event system 7-12(XUM) 

Memory access type 

breakpoints 6-7(XUM) 

Memory Command notebook 
Comp page 6-8(RXRY) 

Copy page 6-8(RXRY) 

Fill page 6-8(RXRY) 

Map page 6-8(RXRY), 6-9(RXRY) 

Search page 6-9(RXRY) 

Stack page 6-7(RXRY), 6-ll(RXRY), 
6-12(RXRY) 

Memory commands 9-6(XUM), 6-8(RXRY) 
ADDRESS 9-6(XUM) 

Amddevice 9-6(XUM) 

ASM 9-6(XUM) 

COMPARE 9-6(XUM), 6-8(RXRY) 
COPY 9.6(XUM), 6-8(RXRY) 

CRC 9-6(XUM) 

DISASSEMBLE 9.6(XUM) 

DNL 9-6(XUM) 

DNL.GAP 9-7(XUM) 

DUMP 9-7(XUM) 

EraseDevice 9-7(XUM) 

ERROR 9-7(XUM) 

PILL 9.7(XUM), 6-8(RXRY) 

POPEN 9-7(XUM) 

FPRINTF 9-7(XUM) 

INCLUDE 9-7(XUM) 

INITREGS 9-7(XUM) 

Inteldevice 9-8(XUM) 

LIST 9-8(XUM) 

LOAD 9-8(XUM) 

LockDevice 9-8(XUM) 
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MAP 9-8(XUM) 

MAPCLR 9-8(XUM) 

MAPLIST 9-8(XUM) 

MEMVARS 9-8(XUM) 
NOMEMACCESS 6-8(RXRY) 
OVERLAY 9-8(XUM) 
OVREADTHRU 9-8(XUM) 
OVWRITETHRU 9-8(XUM) 
RAMACCESS 6-8(RXRY) 

RELOAD 9-9(XUM) 

RemoveDevice 9-9(XUM) 
RESTART 9-9(XUM) 

RESTORE 9-9(XUM) 

RGVERIFY 9-9(XUM) 
ROMACCESS 6-9(RXRY) 

SAVE 9-9(XUM) 

SEARCH 6-9(RXRY) 

SETMEM 9-9(XUM), 6-9(RXRY) 
SETREG 9-9(XUM), 6-9(RXRY) 
SIZE 9-9(XUM) 

TEST 9-9(XUM), 6-9(RXRY) 

UPL 9-10(XUM) 

UPLFMT 9-10(XUM) 

VERIFY 9-10(XUM) 

WHEN 9-10(XUM) 

XLATE 9-10(XUM) 

Memory examination 9-9(XUM) 
Memory window 6-7(RXRY), 6-9(RXRY) 
MEMVARS 9-8(XUM), 9-17(XUM) 
Menubar 3-13(UXRY) 

Menus 

Control Panel 

File 5-5(UXRY), 5-6(UXRY) 

Project 5-5(tJXRY), 5-6(UXRY), 

5-7(UXRY), 5-9(UXRY), 
5-10(UXRY) 

debugger 

Edit 7-l(UXRY), 7-ll(UXRY) 


Defaults Editor 

FUe 6-2(UXRY), 6-8(UXRY), 

6- 9(UXRY) 
definition 3-13(UXRY) 

File 

Change Directory 6-12(RXRY) 

Exit Debugger 6-5(RXRY) 

Load 6-5(RXRY) 

Make and Load 6-5(KXRY) 

Reload 6-5(RXRY) 

Remake and Reload 6-5(RXRY) 
Restart 6-12(RXRY) 

Scope 6-10(RXRY) 

File Editor 7-2(UXRY) 

About 7-2(UXRY) 

Debugger Macros 7-2(UXRY), 

7- 12(UXRY) 

Edit 7-2(UXRY), 7-4(UXRY), 
7-5(UXRY), 7-6(UXRY), 
7-7(UXRY) 

FUe 7-2(UXRY), 7-3(l]XRY), 

7-4(UXRY), 7-5aJXRY), 
7-6(UXRY), 7-12(UXRY) 
Find 7-2(UXRY), 7-7(UXRY), 
7-8(U3flRY) 

Help 7-2(UXRY) 

Locate 7-2(UXRY), 7-10(UXRY) 
View 7-2(UXRY), 7-5(UXRY), 
7-9(UXRY) 
help 4-2(UXRY) 

Bookmark 4-2(UXRY), 4-7(UXRY)- 
4-8(UXRY) 

Edit 4-2(UXRY),4-8(UXRY)- 
4-9(UXRY), 4-10(UXRY) 
FUe 4-2(UXRY),4-9(UXRY), 
4-10(UXRY) 

Help 4-2(UXRY),4-5(UXRY) 
keyboard shortcuts 3-12(UXRY) 


Abbr* 

(RXRY) XRAY Debugger for Wiudows 

(UXRY) XRAY Debugger for Windows 

(XUM) 
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XRAY R^erence Manual 
XRAY User’s Guide 
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paper dip icon 3-12(UXRY) 

root 2-3(UXRY) 

using 3-ll(UXRY)-^-12(UXRY) 

View 

Clear Window 6-13(RXRY) 

Scope to PC 6-10(RXRY) 

Microtec Research toolkit 1-2(RXRY) 
Migration 

related documents P-2(UXRY) 

MMU 

in trace 5-30(XUM) 

MMU support 2-28(XUM), 3-12(XUM) 
MODE 9-4(XUM), S-SQOJM), 9.18(XUM) 
Modes of Control Panel 1-5(UXRY), 
5-2(UXRY) 

Modifying a defaults file 6-2(UXRY>- 
6.8(UXRY) 

Modifying projects 5-7(UXRY)-6-10(UXRY) 
Module (©module) 4-ll(RXRY) 

©module pseudo-register A-l(SXRY), 
B.3(SXRY) 

MONITOR 9.18(XUM) 

Monitor 

related documents P-2(UXRY) 

Motif window frame 3-2(UXRY) 

Motorola ADS board 8-5(XUM) 

Mouse 3-2(UXRY) 

executing commands with 3-7(UXRY)“ 
3.8(UXRY) 

File Editor 7-5(UXRY), 7-6(UXRY) 
scroll bars 3-5(UXRY)-^-6(UXRY) 
windows 3-3(UXRY)-3-5(UXRY) 

Mouse buttons 3-13(UXRY) 

Moving icons 3-3(UXRY) 

Moving in help system 4-4(UXRY)~ 
4-8(UXRY) 

Moving the cursor (Pile Editor) 7-5(UXRY) 
Moving windows 3-3(UXRY) 

Pile Editor 7-5(UXRY) 
mwedit 

(see File Editor) 

MWX-ICE 

command listing 9-l(XUM) 
initialization sequence 2-21(XUM) 
startup 2-4(XUM) 


startup options A-9(XUM) 
startup requirements 2-3(XUM) 
MWX-ICE debugger 1-2(RXRY) 


N 

Naming projects 5-5(UXRY) 

Nested procedure 4-12(RXRY) 

Nesting (@) 4-13(RXRY) 

New command (Control Panel) 5-5(UXRY), 
5-7(UXRY) 

New Editor Copy command (Pile 
Editor) 7-4(UXRY) 

New Editor Empty command (File 
Editor) 7-4(UXRY) 

NEXT 9-26(XUM) 

Next Error command (File 

Editor) 7-10(UXRY) 

No Target Vcc 2-24(XUM) 

NOICE 9-26(XUM) 

NOINTERRUPT 9-26(XUM) 
NOMEMACCESS 9-26(XUM) 
NOMONITOR 9-18(XUM) 

Notational conventions P-4(UXRY), 
P-3(RXRY) 
help 4-3(UXRY) 

Notebooks 3-9(UXRY)-3-10(UXRY), 
2-3(RXRY) 

applying options 3-9(UXRY) 
debugger 

macro page 7-12(UXRY) 

Debugger Files 

Inclpage 6-ll(RXRY), 6-7(RXRY), 
6-9(RXRY) 

Journal page 6-ll(RXRY) 

List page 6-7(RXRY) 

Load page 6-5(RXRY) 

Log page 6-ll(RXRY) 

Scope page 6-10(RXRY) 

Defaults Editor 6-2(UXRY)“6-8(UXRY) 
definition 3-13(UXRY) 
definition files (.dia) 2-5(UXRY) 
Execution Control 6-10(RXRY) 

Break page 6-6(RXRY), 6-12(RXRY) 
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Gro To page 6-6(RXRY) 

GoStep page 6-6(RXRY), 

6-ll(RXRY) 

Step page 6-7(RXRY) 
figure 3-10(lJXRY) 
library icon 3-10(UXRY) 

Memory Command 

Comp page 6-8(RXRY) 

Copy page 6-8(KXRY) 

Fill page 6-8(RXRY) 

Map page 6-8(RXRY), 6-9(RXRY) 
Search page 6-9(RXRY) 

Stack page 6-7(RXRY), 6-ll(RXRY), 
6-12(KXRY) 
opening 3-9(UXRY) 
overview 1-13(UXRY)-1-14(UXRY) 
project definition 5-7(UXRY)-“ 
5-8(UXRY), 5-9(UXRY>- 
5-10(UXRY) 

Symbol Management 

Alias page 6-ll(RXRY) 

Create page 6-10(RXRY), 6-7(RXRY) 
Info page 6-10(KKRY) 

Macro page 6-12(RXRY), 6-7(RXRY), 
6-8(RXRY), 6-9(RXRY) 

Value page 6-8(RXRY) 
tab 3-10(UXRY) 

Utility Commands 

Input page 6-9(RXRY) 

Intrpt page 6-9(RXRY) 

10 Dis page 6-9(RXEY) 

10 Rew page 6-10(RXRY) 

Output page 6-10(RXRY) 

Save page 6-6(RXRY) 

Notes on operation 2-24(XUM) 

Notes, making on help 4-8(UXRY)- 
4-9(UXRY) 

Numbers, specifying 3-10(RXRY) 


0 

Object format 1-9(XUM) 

Ojffset timestamp 5-24(XUM) 

Online Help xvii(XUM) 

On-line help 2-6(RXRY) 

(see Help) 

Open command (Control Panel) 6-6(UXRY) 
Open command (Defaults Editor) 6-2(UXRY) 
Open command (File Editor) 7-3(UXRY) 
Opening a defaults file 6-2(UXRY) 

Opening a file (File Editor) 7-3(UXRY)- 
7-l(UXRY) 

Opening projects 5-6(UXRY) 

Operational notes 2-24(XUM) 

Operations during run 1-4(XUM) 

OPTION 9-4(XUM) 

Options 3-8(UXRY) 

OUTPORT 9-23(XUM) 

OUTPORT command 3-5(RXRY) 
size qualifiers 6-2(RXRY) 
outport macro 3-5(RXRY) 

Output page (Utility Commands 
notebook) 6-10(RXRY) 

OVERLAY 3.16(XUM), 3.18(XUM), 
9-8(XUM) 

Overlay memory 1-5(XUM) 

access qualification 3-7(XUM) 
automatic adjustments 3-ll(XUM) 
bank addressing 3-6(XUM) 
copying memory to 3-16(XUM) 
copying target memory 3-16(XUM) 
copying target to overlay 3-15(XUM) 
downloading to 3-16(XUM) 
errors and warnings 3-14(XUM) 
external bus master 3-4(XUM) 
features 3-3(XUM) 
granularity 3-4(XUM) 
limits 3-6(XUM) 


Abbr. Manual Tide 

(RXRY) XRAY Debugger for Windows XRAY Reference Manual 

(UXRY) XRAY Debugger for Windows XRAY User's Guide 

(XUM) MWX-ICE User's Manual 
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listing and saving map 3-9(XUM) 
logical addresses 3-7(XUM) 
logical addressing 2-32(XUM) 
logical addressing example 3-12(XUM) 
mapping 3-6(KUM), 3-8GCUM), 
3-ll(XUM) 

MMU initialization 3-12(XUM) 
repladngROM 3-2(XUM) 
required termination 3-3(XUM) 
restoring mappings 3-9(XUM) 
returning to target 3-8(XUM) 
sizes available 3-3(XUM) 
specifying access source 3-18(XUM) 
speed 3-3(XUM) 
standard example 3-10(XUM) 
summary of procedures 3-7(XUM) 
theory of operations 3-6(XUM) 
topics in help 3-l(XUM) 
translation tables and 3-12(XUM) 
typical uses 3-2(XUM) 
Overlay.,endpoints adjusted 3-14(XUM) 
OVREADTEIRU 3^(XUM), 9.8(XUM) 
OVWRITETHRU 3-4(XUM), 9-8(XUM) 

p 

Pair Matching command (File 
Editor) 7-8(UXRY) 

Paper clip icon on menus 3-12(lJXRY) 
Paste command (File Editor) 7-6(UXRY) 
Pasting text 3-ll(UXRY) 

Patching source 6-ll(RXRY) 

Path 2-2(UXRY) 

PAUSE 9-12(XUM), 9-23(XUM) 
Peeks/Pokes 

tracing 5-9(XUM) 

Personal IMtor command (File 
Editor) 7-4(UXRY) 

Phone support xx(XUM) 

Physical address 5-30(XUM) 

^i pseudo-register A-l(SXRY), B-3(SXRY) 
@pisize pseudo-register A-l(SXRY), 
B.3(SXRY) 

Placeholders (help) 4-7(UXRY)-4-8(UXRY) 


Pop-up hyperlink 4-5(UXRY) 

PORESET 9-12(XUM), 9-19(XUM) 

Port I/O and interrupt commands 6-9(RXRY) 
DIN 9-23(XUM), 6-9(RXRY) 

DOUT 9-23(XUM), 6-9(RXRY) 

INPORT 9-23(XUM), 6-9(RXRY) 
INTERRUPT 6-9(RXRY) 
NOINTERRUPT 6-9(RXRY) 

OUTPORT 9-23(XUM), 6-10(RXRY) 
PAUSE 9-23(XUM) 

RIN 9-23(XUM), 6-10(RXRY) 

ROUT 9-23(XUM), 6-10(RXRY) 

Port FO simulation 9-23(XUM) 

@port_addr pseudo-register A-l(SXRY), 
B-3(SXRY) 

Port_address (definition) 6-3(RXRY) 
@port_size pseudo-register A-l(SXRY), 
B-3(SXRY) 

@port_value pseudo-register A-2(SXRY), 
B-4(SXRY) 

Position Defaults 6-5(UXRY) 

Power loss, target 2-24(XUM) 

Power-on 

control program 

initialization 2-21(XUM) 
emulator initialization 2-20(XUM) 
sequence 2-7(XUM) 

tracing during target power-on 5-3(XUM) 
PPT 2-25(XUM), 9-13(XUM) 

Preparing programs for debugging 
command files 2-3(RXRY) 

Previous Error co mm and (File 
Editor) 7-10(UXRY) 

Print button 6-8(RXRY) 

Print co mm and (File Editor) 7-4(UXRY) 
PRINTANALYSIS 9-26(XUM) 

PrinterSetup command (help) 4-10(UXRY) 
PRINTF 9-18(XUM) 

PRINTF command 3-9(RXRY) 

Printing a file (File Editor) 7-4(UXRY) 
Printing a help item 4-9(UXRY)-4-10(UXRY) 
PRINTPROFILE 9-26(XUM) 
PRINTSYMBOLS 9-18(XUM), 9-22(XUM) 
PRINTSYMBOLS command 3-9(RXRY) 
errors 3-8(RXRY) 
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PrintTopic command (help) 4-9(UXRY)- 
4-10(UXRY) 

PRINTTYPE 9-18(XUM), 9-22(XUM) 
PRINTVALUE 9-18(XUM), 9-22(XUM) 
Procedure (@procedtffe) 4-ll(RXRY) 
procedure pseudo-r^ister A-2(SXRY), 
B-4(SXRY) 

Procedure, nested 4-12(RXRY) 

Processor 

changing for a project 5-9(UXRY) 
Product development cycle 1-4(UXRY)- 
1-12(UXRY) 

PROFILE 9-26(XUM) 

Program stack references 4-12(RXRY) 
Programming flash 4-l(XUM) 
macros 4-6(XUM) 

Project Control Panel 
(see Control Panel) 

Project menu 

Control Panel 5-5(UXRY), 5-6(UXRY), 
5-7(UXRY), 5-9(UXRY), 
5-10(UXRY) 

Projects 5-4(UXRY)-5-10(UXRY) 
adding/deleting tools 5-9(UXRY>- 
5-10(UXRY) 
control panel for 

(see Control Panel, project) 
creating 5-5(UXRY)-5-6(UXRY) 
default projects 5-8(UXRY) 
files 2-5(l)XRY) 

definition 1-3(UXRY), 5-4(UXRY) 
deleting S-lOdJXRY) 
files 2-5(UXRY), 5-4(UXRY) 
deleting 5-10(UXRY) 
modifying 5-7(UXRY)-5-10(I)XRY) 
naming 5-5(UXRY) 
notebook 5-7(UXRY)-5-8(UXRY), 
5-9(UXRY)-5-10(UXRY) 


opening 5-6(UXRY) 
target prcx»ssor 

changing 5-9(UXRY) 
Pseudo-registers A-l(SXRY) 

@addr A-1(SXRY), B-l(SXRY), 
B-4(SXRY) 

@as A-KSXRY), B-l(SXRY) 

©chip A-1(SXRY), B-1(SXRY) 

©cycles A-KSXRY), B-l(SXRY), 
B-5(SXRY) 

©entry A-l(SXRY), B-l(SXRY) 

©exc A-1(SXRY),B-2(SXRY),B-5(SXRY) 
©file A-1(SXRY), B-2(SXRY) 

©fpf A-KSXRY), B-2(SXRY) 

©fpu A-KSXRY), B-2(SXRY),B-5(SXRY), 
B-10(SXRY) 

®ilpc 4-lKRXRY), A-KSXRY), 
B-3(SXRY) 

©line.range A-KSXRY), B-3(SXRY) 
©module 4-lKRXRY), A-KSXRY), 
B-3(SXRY) 

©pi A-KSXRY), B-3(SXRY) 

©pisize A-KSXRY), B-3(SXRY) 
©port.addr A-KSXRY), B-3(SXRY) 
©port.size A-KSXRY), B-3(SXRY) 
%ort_value A-2(SXRY), B-4(SXRY) 
procedure 4-lKRXRY), A-2(SXRY), 
B-4(SXRY) 

©root 4-10(RXRY),A-2(SXRY), 
B-KffllRY) 

©wait_state A-2(SXRY), B-4(SXRY), 
B-6(SXRY) 


Q 

Qualified reference 4-9(RXRY) 
Qualifying trace 5-10(XUM) 
Question mark icon 4-l(UXRY) 


Abbr. 

(RXRY) XRAY Debugger for Windows 

(UXRY) XRAY Debugger for Windows 

(XUM) 
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XRAY Reference Manual 
XRAY User^s Guide 
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Questions and answers 

learning to use XRAY 3-l(RXRY) 
managing XRAY files 3-6(RXRY) 
using XRAY variables 3-8(RXRY) 
QUICC registers 8-10(XUM) 

QUIT 9-4(XUM) 

Quitting File Editor 7-4(UXRY>-7-5(UXRY) 
Quitting windows 3-4(UXRY)-3-5(UXRY) 


R 

Radio buttons 3-8(UXRY) 
definition 3-13(UXRY) 
figure 3-8(UXRY) 

RAMACCESS 9.26(XUM) 

Raw trace display 5-35(XUM) 

Read-Only check box (File Editor status 
fine) 7-3(UXRY) 

Realtime operation 

event system 7-23(XUM) 

Rebuilding applications 1-17(UXRY) 

Recall button 6-ll(RXRY) 

Recursive fimctions 

setting breakpoints 4-13(RXRY) 
using GO command 4-13(RXRY) 
Reference 4-12(RXRY) 
qualified 4-9(RXRY) 

Register support 1-6(XUM) 

Register window 6-9(RXRY) 

Registers 

configuring 8-9(XUM) 
event system 7-20(XUM) 
initregs command 8-7(XUM) 
setting 8-10(XUM) 
view/modify 8-10(XUM) 

RELOAD 9.9(XUM) 

RemoveDevice 4-ll(XUM), 9-9(XUM) 
Removing projects 5-10(UXRY) 

Removing text (File Editor) 7-6(UXRY) 
Rename command (Control 

Panel) 5-7(UXRY), 5-9(UXRY) 
ReOpen command (File Editor) 7-5(UXRY) 
Replacing strings (File Editor) 7-8(UXRY) 
Reserved symbols A-l(SXRY) 


Reserved words A-l(SXRY) 

RESET 2-21(XUM), 2-22(XUM), 9-12(XUM), 
9-19(XUM) 

Reset 

button 2-22(XUM) 
emulator 2-22(XUM) 
hardware 2-22(XUM) 
software 2-21(XUM) 
tracing during reset 5-3(XUM) 

Resizing viewports 3-4(RXRY) 

Resizing windows 3-3(UXRY>-3-4(UXRY) 
Resources 

access breakpoints 6-ll(XUM) 
breakpoints and event system 6-2(XUM) 
event system 7-26(XUM) 
instruction breakpoints 6-17(XUM) 
RESTART 2-22(XUM), 9-9(XUM), 9-12(XUM) 
RESTORE 9-9(XUM) 

RETURN statement in macros 6-6(RXRY) 
RGVERIFY 9-9(XUM) 

RIN 9-23(XUM) 

ROM, replacing with overlay 3-2(XUM) 
ROMACCESS 9-26(XUM) 

Root(@) 4-10(RXRY) 

Root menu 2-3(UXRY) 

Root names 4-10(RXRY) 

©root pseudo-register 4-10(RXRY), 
A-2(SXRY), B-4(SXRY) 

ROUT 9-23(XUM) 

Routine Information dialog (Source 
Explorer) 7-10(UXRY) 

RTE 9-19(XUM) 

Rule field (XRAY Make) 7-9(UXRY) 
RUN_POLL 9-19(XUM) 

RUN.TIME 9.19(XUM) 


s 

SAVE 9-9(XUM) 

Save As command (Defaults 
Editor) 6-9(UXRY) 

Save As command (File Editor) 7-4(UXRY) 
Save command (Defaults Editor) 6-8(UXRY) 
Save command (File Editor) 7-4(UXRY), 
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7-12(lJXRY) 

Save page (Utility Commands 
notebook) 6-6(KXRY) 

Saving 

macros 6-9(RXRY) 

Saving a defaults file 6-8(UXRY) 

Saving a file (File Editor) 7-4(UXRY) 

Saving commands 3-4(RXRY) 

JOURNAL command 3-4(RXRY) 

LOG command 3-4(RXRY) 

Saving configuration 2-ll(XUM) 

SCMI 

(see Source Control Management Inter¬ 
face) 

SCMI Defaults 6.8(UXRY) 

SCMI Layout 

files 2-5(UXRY) 

SCOPE 9-22(XUM) 

Scope button 6-10(RXRY) 

SCOPE command 3-l(RXRY), 3-9(RXRY) 
Scope page (Debugger Files 

notebook) 6-10(RXRY) 

Scoping rules 4-8(RXR10 
Scroll bars 3-5(UXRY)-3-6(UXRY) 
definition 3-13(UXRY) 
figure 3-6(UXRY) 
infinite 3-6(UXRY) 

Search and replace in File Editor 7-8(UXRY) 
Search Backward command (File 
Editor) 7.7(UXRY) 

Search button 

help 4-2(UXRY), 4-6(UXRY)-4-7(UXRY) 
SEARCH command 

size qualifiers 6-2(RXRY) 

Search page (Memory Command 
notebook) 6-9(RXRY) 

Search paths 2-4(UXRY>-2-5(UXRY) 
Searching for string in File 


Editor 7-7(UXRY)-7-8(UXRY) 
Searching in help system 4-6(UXRY)“ 
4-7(UXRY) 

Selecting text (File Editor) 7-6(UXRY) 

Send macro to Debugger command (File 
Editor) 7-12(UXRY) 

Sequences, browse 4-5(UXRY)-4-6(UXRY) 
SERIAL.CORE 9.12(XUM) 

Session control 9-4(XUM) 

JOURNAL 9-4(XUM) 

LOG 9-4GaJM) 

MODE 9-4(XUM) 

OPTION 9-4(XUM) 

QUIT 9-4(XUM) 

SETSTATUSDIR 9.4(XUM) 
SETSTATUS 

ENVIRONMENT 9-4(XUM) 
Session control commands 6-5(RXRY) 

HOST 6.5(RXRY) 

LOAD 6.5(RXRY) 

QUIT 6-5(RXRY) 

RELOAD 6-5(RXRY) 

RESTORE 6-6(RXRY) 

SAVE 6-6(RXRY) 

SETMEM 9-9(XUM) 

SETMEM command 3-10(RXRY) 
size qualifiers 6-2(RXRY) 

SETREG 8-10(XUM), 8.11(XUM), 9.9(XUM) 
SETSTATUSDIR 9-4(XUM) 

SETSTATUS ENVIRONMENT 9-4(XUM) 
SETSTATUS EVENT 9-26(XUM) 
SETSTATUS QUALIFY 9-26(XUM) 
SETSTATUS READ 9-26(XUM) 
SETSTATUS TRACE 9-26(XUM) 
SETSTATUS TRIGGER 9-26(XUM) 
SETSTATUS VERIFY 9.26(XUM) 
SETSTATUS WRITE 9.26(XUM) 


Abbr. 

(RXRY) XRAY Debugger for Windows 

(UXRY) XRAY Debugger for Windows 

(XUM) 


Manual Tide 
XRAY Reference Manual 
XRAY Users Guide 
MWX-ICE Users Manual 
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Setting breakpoints 
(see Breakpoints) 

Setting up XRAY MasterWorks 
tools 1-4(UXRY)-1-7(UXRY) 

Setting your path 2-2(UXRY) 

Set-up file 2-5(UXRY) 

Shared libraries 2-2(UXRY), 2-5(UXRY) 
SHOW 9-21(XUM) 

Show cydes 6-ll(XUM) 

Show Insert Cursor command (File 
Editor) 7-5(UXRY) 

Show Last Change Line command (File 
Editor) 7-5(UXRY) 

SHOWmST 9-13(XUM) 

SIGA_MUX 7-7(XUM), 9-13(XUM), 
9-15(XUM) 

SIGB.MUX 7-7(XUM), 9.13(XUM), 
9-15(XUM) 

Signal timing 2-26(XUM) 

Simple Editor command 

(debugger) 7-ll(UXRY) 

Simulated I/O 3-5(RXRY) 

Simulating 

i/o 9.23(XUM) 
interrupts 9-23(XUM) 

Single-stepping 2-26(XIJM), 9-12(XUM), 
2-80RXRY) 

SIT 9-12(XUM), 9-19(XUM) 

SIT mode 1-5(XIJM) 

SITSTATE 9-12(XUM), 9-19(XUM) 

SIZE 9-9(XUM) 

Soffcswitches 9-19(XUM) 

Software breakpoint 6-4(XlJM), 6-12(XUM) 
Software installation xviii(XUM) 

Software performance report 1-15(UXRY)“ 
1-16(UXRY) 

Source Control Management 
Interface 1-3(IJXRY) 
overview 1-6(UXRY>-1-7(UXRY) 

Source Explorer 1-3(UXRY), 1-2(RXRY) 
Browse button 7-10(UXRY) 
debugger, communicating 
with 1-17(UXRY) 

File Editor in 7-10(UXRY>-7-ll(UXRY) 
notebooks 1-14(UXRY) 


overview 1-10(XJXRY)-1-11(UXRY) 
XRAY Make, communicating 
with 1-17(UXRY) 

Source file 

assembly 3-l(RXRY) 
high-level 3-l(RXRY) 
location 3-6(RXRY) 

Source patching 6-ll(RXRY) 

SREC format 3-15(XUM) 

Stack 

explicit references to 4-13(RXRY) 
implicit references to 4-12(RXRY) 
Stack levels 

displaying 3-2(RXRY) 
jumping 3-2(RXRY) 

Stack page (Memory Command 

notebook) 6-7(RXRY), 6-ll(RXRY), 
6-12(RXRY) 

Starting 

emulator and target 2-7(XUM) 
MWX-ICE 2-3(XUM) 
target code 2-22(XUM) 

STARTUP 9-27(XUM) 

Startup 

file,creating 2-ll(XUM) 
options A-9(XUM) 
requirements 2-3(XUM) 

STARTUP command 3-4(RXRY) 

Startup include file A-4(XUM) 
startupinc A-4(XUM) 
startup.xry file 3-4(RXRY) 

STATE 9-15(XUM) 

States 

event system 7-18(XUM) 

STATUS 9-18(XUM), 9-24(XUM) 

Status 

bus master 2-27(XUM) 
displaying in File Editor 7-9(UXRY) 
STATUS BUFFER 9-27(XUM) 

Status commands 9-17(XUM) 

STATUS EVENT 9-27(XUM) 

Status line in File Editor 7-3(UXRY) 

File 7-3(UXRY) 

Line 7-3(UXRY), 7-5(UXRY) 

Read-Only 7-3(UXRY) 


SuperTAPSXX 


Master Index-25 



STATUS QUALIFY 9-27(XUM) 

STATUS TRACE 9-27(XUM) 

STATUS TRIGGER 9-27(XUM) 

STEP 9-12(XUM) 

STEP command 2-8(RXRY), 3-2(RXRY) 

Step page (Execution Control 
notebook) 6-7(RXRY) 

Stepinstr button 6-7(RXRY) 

StepLine button 6-7(RXRY) 

STEPOVER 9-12(XUM) 

StepOver button 6-7(RXRY) 

STEPOVER command 2-8(RXRY), 
3-2(RXRY) 

Stepping 3-2(RXRY) 

(see also Single-stepping, STEP command, 
STEPOVER command) 

Stop at top/bottom command (File 
Editor) 7-7(UXRY) 

Stop execution 3-3(RXRY) 

Stop-in-target mode 1-5(XUM) 

Storage classes 4-5(RXRY) 

(see also S 3 mibolic references, storage 
classes) 

SuperTAP Flash ROM 
updating D-1(XUM) 

Support xx(XUM) 

Symbol (definition) 6-3(RXRY) 

Symbol commands 6-10(RXRY) 

ADD 9-22(XUM), 6-10(RXRY) 

BROWSE 9-22(XUM) 

CEXPRESSION 9.22(XUM) 

CONTEXT 9-22(XUM), 6.10(RXRY) 
DELETE 9-22(XUM), 6-10(RXRY) 
EXPAND 9-22(XUM) 

PRINTSYMBOLS 9-22(XUM), 
6-10(RXRY) 

PRINTTYPE 9-22(XUM), 6.10(RXRY) 
PRINTVALUE 9-22(XUM) 


SCOPE 9-22(XUM), 6.10(RXRY) 
S 3 mibol Management notebook 
Alias page 6-ll(RXRY) 

Create page 6-10(RXRY), 6-7(RXRY) 
Info page 6-10(RXRY) 

Macro page 6-12(RXRY), 6-7(RXRY), 
6-8(RXRY), 6-9(RXRY) 

Value page 6-8(KXRY) 

Symbolic references 3-8(RXRY), 4-5(RXRY) 
data types 4-6(RXRY) 

l^e casting 4-7(RXRY) 
type conversion 4-7(RXRY) 
variable references 4-ll(RXRY) 
program stack 4-12(RXRY) 

explicit references 4-13(RXRY) 
implicit references 4-12(RXRY) 
qualifi^ reference 4-9(RXRY) 
scoping rules 4-8(RXRY) 
storage classes 

local 4-5(RXRY) 
register 4-5(RXRY) 

Symbols 

address 4-l(RXRY) 
as command parameters 6-3(RXRY) 
debug information 3-8(RXRY) 
local 6-7(RXRY) 

PRINTSYMBOLS cannot 
find 3-8(RXRY) 
qualified 6-3(RXRY) 
reserved A-l(SXRY) 

XRAY cannot find 3-8(RXRY) 

Symbols in trace 5-34(XUM) 


T 

TA/TEA 3-3(XUM) 

Target fimctions 4-4(RXRY) 
Target isolation mode 2-19(XUM), 


Abbr. Manual Title 

(RXRY) XRAY Debugger for Windows XRAY Reference Manual 

(UXRY) XRAY Debugger for Windows XRAY User*s Guide 

(XUM) MWXdCE User's Manual 
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2-24(XUM) 

Target processor 

project 5-9(UXRY) 

Target Vcc Not Foimd 2-19(XUM), 

2- 24(XUM) 

Technical support xx(XUM) 

Temporary breakpoints 6-14(XUM), 

3- 3(KXRY) 

Temporary file 2-2(UXRY) 

Termination in overlay 3-3(XlJM) 

TEST 9-9(XUM) 

TEST command 

size qualifiers 6-2(RXRY) 

Test target 8-5(XUM) 

Text 

copying 3-ll(UXRY) 
copying in Pile Editor 7-6(UXRY) 
deleting in File Editor 7-6(UXRY) 
entering 3-ll(UXRY) 
formatting in File Editor 7-6(UXRY)“ 
7-7aJXRY) 

inserting in File Editor 7-6(UXRY) 
pasting 3-ll(XJXRY) 
selecting in File Editor 7-6(UXRY) 
typing 3-ll(UXRY) 

Text editor 

(see Pile Editor) 

(see File Editor)* 

Text fields 

definition 3-13(UXRY) 

Text viewer 

moving in File Editor 7-5(UXRY) 
TGTMODE 9-18(XUM) 

TIMCLK 5-25(XUM), 9-14(XUM) 
Timestamp 5-3(XlJM), 5-24(XUM) 

Timing 5-3(XIJM) 

Timing, AC signal 2-26(XUM) 

Title line in help 4-6(UXRY) 

Tool Output area (XRAY Make) 7-9(lJXRY) 
Toolkit 1-2(RXRY) 

Tools in XRAY MasterWorks 1-2(UXRY)- 
1-3(UXRY) 

(see also under specific name) 
adding/deleting in projects 5-9(UXRY)- 
5.10(UXRY) 


building 1-7(UXRY)-1-10(UXRY) 
configuration 1-4(UXRY)-1-7(IJXRY) 
debugging 1-10(UXRY)-1-12(UXRY) 
invoking 5-3(UXRY)-5-4(UXRY) 
auto start 5-10(UXRY) 
overviews 1-4(UXRY)“1-12(UXRY) 
tools^cp file 2-5(UXRY) 

TRACE 5-8(Xm), 9-14(XUM) 

Trace 1-7(XUM) 

assembly instruction in 5-33(XlJM) 

C source in 5-33(XUM) 
clearing at run 5-8(XUM) 
compression 5-31(XUM) 
configuring 5-8(XUM)--?? 
continuous raw 5-8(XUM), 5-22(XUM) 
data display 5-24(XUM) 
disassembled 5-10(XUM), 6-25(XUM) 
disassembly problems 5-32(XUM) 
displaying ??-5-32(XUM) 
dynamic 5-3(XUM), 5-4(XUM) 
peek/poke 5-9(XUM) 
power-up cycles 5-3(XUM) 
preventing overwriting 5-9(XUM) 
qualified 5-3(XUM), 5-10(XUM) 
raw field descriptions 5-35(XUM) 
reset sequences 5-3(XUM) 
saving to a file 5-3(XUM) 
selecting display fields 5-23(XUM) 
s3nnbols 5-34(XUM) 
timestamp 5-3(XUM) 
using MMU 5-30(XUM) 
view while running 5-3(XUM), 5-4(XUM) 
Trace Back window 3-2(RXRY) 

Trace commands 5-8(XUM)-5-ll(XUM), 
5-25(XUM), 9-13(XUM) 

DRT 9-13(XUM) 

DRTDATA 5-22(XUM), 5-24(XUM), 
9-13(XUM) 

DRTFULL 6.22(XUM), 9-13(XUM) 
DRTOPTn 5-23(XUM) 

DT 5-25(XUM), 9-13(XUM) 

DTB 9-13(XUM) 

DTP 5-25(XUM), 9-13(XUM) 

DXINSERT 5.25(XUM), 9-13(XUM) 
DXLABELS 9.13(XUM) 
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DXMMU 5-25(XUM) 

PPT 9-13(XUM) 

SHOWINST 9-13(XUM) 

SIGA. MUX 9-13(XUM), 9-15(XUM) 

SIGB. MUX 9-13(XUM), 9-15(XUM) 
TIMCLK 9-14(XUM) 

TRACE 9-14(XUM) 

TRBASE 9-14(XUM) 

TRCEXT 9-14(XUM) 

TRCINT 9-14(XUM) 

TOCLR 9-14(XUM) 

TRDISP 5-25(XUM), 9-14(XUM) 
TRFRAMES 9-14(XUM) 

TRQUAL 9-14CXUM) 

TRRUNCLR 9-14(XUM) 

TRSYS 9-14(XUM) 

TSRCH 9-14(XUM) 

TSTAMP 9-14(XUM) 

Trace compression 5-31(XIJM) 

Tracing B-7(SXRY) 

Translation tables 2-28(XUM), 3-12(XUM) 
TRBASE 5-25(XUM), 9.14(XUM) 

TRCEXT 9-14(XUM) 

TRCINT 9-14(XUM) 

TRCLR 9-14(XUM) 

TRDISP 9-14(XUM) 

TRFRAMES 9-14(XUM) 

Triggers 

external 7-20(XUM) 

TRINIT 5-8(XUM) 

Troubleshooting B-1(XUM), 1-15(UXRY)- 
1-16(UXRY) 

TRQUAL 5-8(XUM), 9-14(XUM) 
TRRUNCLR 5-8(XUM), 9-14(XUM) 
TRSTAMP 5-25(XUM) 

TRSYS 5-8(XUM), 9-14(XUM) 

TSRCH 9-14(XUM) 

TSTAMP 9-14(XUM) 


Tutorial P-1(UXRY) 

Type casting 4-7(RXRY) 

Type conversions 4-7(RXRY) 

Types, data 4-6(RXRY) 

Typing text 3-ll(UXRY) 

Typing text (Pile Editor) 7-6(UXRY) 

u 

Underlined words in help 4-5(UXRY) 

Undo command (File Editor) 7-5(UXRY) 
UNIX system environment 

variables 2-l(UXRY) 

UNKNOWN TYPE 3-9(RXRY) 
UnlockDevice 4-10(XUM), 9-9(XUM) 
Unreferenced variable 4-12(RXRY) 
Unsupported commands 9-26(XUM) 
imtil macro 3-3(RXRY) 

UP 9-18(XUM) 

Up button 6-12(RXRY) 

Up item in help 4-6(UXRY) 

Updating 

firmware D-1(XUM) 

UPL 3-17(XUM), 9-10(XUM) 

UPLFMT 9-10(XUM) 

Uploading object code 3-17(XUM) 

User Interface 

(see Graphical User Interface) 

User interface 
(see Interface) 

Using debugger macros 2-5(RXRY) 

Using the Pile Editor 7-3(UXIlY)- 
7-12(UXRY) 

in other tools 7-9(UXRY)-7-12(UXRY) 
USR_MRI environment variable 2-2(UXRY), 
2^(UXRY), 6-2(UXRY), 3-6(RXRY) 
Utility commands 6-ll(RXRY) 

ALIAS 9-24(XUM), 6.11(RXRY) 


Abbr. 

(RXRY) XRAY Debugger for Windows 

(UXRY) XRAY Debugger for Windows 

(XUM) 


Manual Title 
XRAY Reference Manual 
XRAY User's Guide 
MWX-ICE User's Manual 
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CEXPRESSION 6-ll(KXRY) 

DOWN 6-ll(RXRY) 

ERROR 6-ll(RXRY) 

HELP 6-ll(RXRY) 

HISTORY 6-ll(RXRY) 

INCLUDE 6-ll(RXRY) 

JOURNAL 6-ll(RXRY) 

LOG 6-ll(RXRY) 

MODE 6-ll(RXRY) 

OPTION 6-ll(RXRY) 

PAUSE 6-ll(RXRY) 

RESET 6-ll(RXRY) 

RESTART 6-12(RXRY) 
SETSTATUSDIR 6-12(RXRY) 
SETSTATUS 

ENVIRONMENT 6-12(RXRY) 
SETSTATUS READ 6-12(RXRY) 
SETSTATUS VERIFY 6-12(RXRY) 
SETSTATUS WRITE 6-12(RXRY) 
STARTUP 6-12(RXRY) 

STATUS 9-24(XUM), 6-12(RXRY) 

UP 6-12(RXRY) 

XLATE 9-24(XUM) 

Utility Commands notebook 
Input page 6-9(RXRY) 

Intrpt page 6-9(RXRY) 

10 Dis page 6-9(RXRY) 
lORewpage 6-10(RXRY) 

Output page 6-10(RXRY) 

Save page 6-6(RXRY) 

V 

VACTIVE 9-5(XUM) 

Value page (Symbol Management 
notebook) 6-8(RXRY) 

Variables 

assigning value to 3-10(RXRY) 
debug information 3-8(RXRY) 

FILL command 3-10(RXRY) 
format 3-9(RXRY) 
monitoring 

scalar 3-10(RXRY) 

SEIMEM command 3-10(RXRY) 


setting breakpoints at access 
to 3-3(RXRY) 

UNKNOWN TYPE 3-9(RXRY) 

Vcc 2-24(XUM) 

VCLEAR 9-5(XUM) 

VCLOSE 9-5(XUM) 

VERIFY 9-10(XUM) 

VFCNT 5-31(XUM) 

VFMSG 5-31(XUM) 

\^ew menu 

Clear Window 6-13(RXRY) 

File Editor 7.2(UXRY), 7-5(UXRY), 
7-9(UXRY) 

Scope to PC 6-10(RXRY) 

Viewer 

moving in File Editor 7-5(UXRY) 
Viewports 

resizing 3-4(RXRY) 

VISUAL environment variable 1-8(UXRY), 
7-4(UXRY) 

VMACRO 9-5(XUM), 9-21(XUM) 

VOPEN 9-5(XUM) 

VSETC 9.5(XUM) 


w 

@wait_state pseudo-raster A-2(SXRY), 
B-4(SXRY) 

Warranty xx(XUM) 

WHEN 9-10(XUM), 9-15(XUM) 
when macro 3-3(R5QtY) 

When/then 

actions 7-9(XUM) 
clear 7-14(XUM) 
clearing 7-14(XUM) 
commands 7-5(XUM) 
coimters 7-18(XUM) 
display 7-13(XUM) 
enable 7-14(XUM) 
events 7-8(XUM) 
features 7-2(XUM) 
groups 7-15(XUM) 
macros 7-21(XUM) 
memory 7-20(XUM) 
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memory accesses 7-12(XUM) 
realtime operation 7-23(XUM) 
registers 7-20(XUM) 
resources 7-26(XUM) 
statements 7-8(XUM) 
states 7-18(XUM) 
structure 7-3(XUM) 
syntax 7-7(XUM) 
triggers 7-20(XUM) 
valid statements 7-ll(XUM) 
WHENCLR 9-15(XUM) 

WHENDISABLE 9.16(XUM) 
WHENENABLE 9-16(XUM) 

WHENLIST 9-16(XUM) 

Where am I command (File 
Editor) 7-9(lJXRY) 

WHILE statement in macros 6-7(RXRY) 
Window Control 

MODE 9.5(XUM) 

Window control 9-5(XUM) 

VACTIVE 9-5(XUM) 

VCLEAR 9-5(XUM) 

VCLOSE 9-5(XUM) 

VMACRO 9-5(XUM) 

VOPEN 9-5(XUM) 

VSETC 9-5(XUM) 

Windows 

Breakpoints 6-6(RXRY), 6-7(RXRY) 
closing 3-4(UXRY>-3-5(UXRY) 

Code 6-6(RXRY),6.7(RXRY),6-8(RXRY), 
6-10(RXRY), 6-ll(RXRY), 
6-12(RXRY) 

Command 6-7(RXRY), 6-8(RXRY), 
6-ll(RXRY), 6-13(RXRY) 
definition 3-13(lJXRY) 
help 4-l(UXRY)-4-2(UXRY) 
iconifying 3-4(lJXRY) 

Inspector 6-7(RXRY), 6-8(RXRY) 


Memory 6-7(RXRY), 6-9(RXRY) 
Motif window fi-ame 3-2(UXRY) 
moving 3-3(UXRY) 

File Editor 7.5(UXRY) 
Register 6-9(RXRY) 
resizing 3-3(UXRY)-3-4(UXRY) 
Trace Back 3-2(RXRY) 

WWW xxCXUM) 


x-r-z 

JCdefaultsfile 4-10(UXRY) 

XICEVARS 9-18(XUM) 

XLATE 9-10(XUM), 9-18(XUM), 9.24(XUM) 
XRAY commands 9-l(XUM) 

XRAY Control Panel 
(see Control Panel) 

XRAY Debugger 1-3(UXRY) 

related documents P-2(UXRY) 

XRAY environment variable 2-2(UXRY), 
3-6(RXRY) 

XRAY Make 1-3(UXRY), 1-2(RXRY) 

Build button 7-9(U33lY) 
debugger, communicating 
with 1-17(UXRY) 

Error button 7-9(IJXRY) 

File Editor in 1-16(UXRY), 7-9(UXRY)- 
7-10(UXRY) 
notebooks 1-14(UXRY) 
overview 1-8(UXRY>-1-10(UXRY) 

Rule field 7-9(UXRY) 

Source Explorer, communicating 
with 1-17(UXRY) 

Tool Output area 7-9(UXRY) 

XRAY Master 

related documents P-2(UXRY) 
XRAYMasterWorks 1-1(UXRY)-1-17(UXRY) 
About Box 1-15(UXRY)-1-16(UXRY) 


Abbr. 

(RXRY) XRAY Debugger for Windows 

(UXRY) XRAY Debugger for Windows 

(XUM) 


Manual Title 

XRAY Reference Manual 
XRAY User^s Guide 
MWX-ICE User's Manual 
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communication between 

tools 1.16(UXRY)-1-17(UXRY) 
Eile Editor and 

debugger 7-ll(UXRY>- 
7-12(UXRY) 

File Editor and other 

tools 1-16(UXRY), 
7-9(UXRY)-7-12(UXRY) 
File Editor and Source 

Explorer 7-10(UXRY)- 
7.11(UXRY) 

File Editor and XRAY 

Make 1-16(UXRY), 
7.9(UXRY)-7-10(UXRY) 
prerequisite 5-4(UXRY) 

Source Explorer and 

debugger 1-17(UXRY) 
XRAY Make and 

debugger 1-17(UXRY) 
XRAY Make and 

Explorer 1-17(UXRY) 
configuration 1-4(UXRY)-1-7(UXRY) 
figure 1-2(UXRY) 
help 

(see Help) 
interface 

(see Interface) 
invocation 2-4(lJXRY) 
product development cycle 1-4(UXRY)- 
1-12(UXRY) 

related documents P-1(UXRY) 
root menu, including in 2-3(UXRY) 
set-up file 2-5(UXRY) 
tools included 1-2(IJXRY>-1-3(UXRY) 
auto start 5-10(UXRY) 
invoking 5-3(UXRY)-5-4(lJXRY) 
overviews 1-4(UXRY>-1-12(UXRY) 
XRAY MasterWorks base 

directory 2-4(UXRY) 

XRAY MasterWorks Control Panel 
(see Control Panel) 

XRAY MasterWorks Debugger 
(see Debugger) 

XRAY MasterWorks Defaults Editor 
(see Defaults Editor) 


XRAY MasterWorks File Editor 
(see File Editor) 

XRAY MasterWorks home 

directory 2-4(UXRY) 

XRAY MasterWorks Source Control Manage¬ 
ment Interface 

(see Source Control Management Inter¬ 
face) 

XRAY MasterWorks Source Explorer 
(see Source Explorer) 

XRAY MasterWorks XRAY Debugger 
(see XRAY Debugger) 

XRAY MasterWorks XRAY Make 
(see XRAY Make) 

XRAYMASTER 2-2(XUM), B-2(XUM) 
XRAYMASTER environment 

variable 2-l(UXRY), 2-4(UXRY), 
6-2(UXRY) 

XRAYMASTER_HOME environment 

variable 2-2(UXRY), 6-2(UXRY) 
XRAYMASTER.TMP environment 

variable 2-2(UXRY), 2-4(UXRY) 
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Applied 

Microsy^ems 

Corporation 

Applied Microsystems Corporation maintains a worldwide network of direct offices committed to quality 
service and support. For information on products, pricing, or delivery, please call the nearest office listed 
below. In the United States, for the number of the nearest local office, call 1-800-426-3925. 

CORPORATE OFFICE 

Applied Microsystems Corporation 
5020148th Avenue Northeast 
P.O. Box 97002 
Redmond, WA 98073-9702 
(206) 882-2000 
1-800^26-3925 
Customer Support 
1-800-ASK-4AMC (1-800-275-4262) 

TRT TELEX 185196 
FAX (206) 883-3049 

Internet Home Page; http://www.amc.com 

EUROPE 

Applied Microsystems Corporation Ltd. 

AMC House 
South Street 
Wendover 
Buckinghamshire 
HP22 6EF United Kingdom 
44 (0) 296-625462 
Telex 265871 REF WOT 004 
FAX 44 (0)296-623460 

JAPAN 

Applied Microsystems Japan, Ltd. 

Arco Tower 13 F 
1-8-1 Shimomeguro 
Meguro-ku 
Tol^o 153, Japan 
81-3-3493-0770 
FAX 81-3-3493-7270 
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Initial reiease of the MWX-ICE Debugger for 

2/97 


Windows (SuperTAP MPCSXX). 
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